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Section 1. USB08 Quick Start 



1.1 Contents 



12 Introduction, „ , , „ , .. , .. < .. , .. < ..,..,..,.. ■ -. ,17 

1-3 Required System Configuration ■ 17 

1 .4 Connecting the Demo Board !o the PC . . ■ . . , »--•--- 18 

1 <5 Driver Installation .,..,„< < . . < , . . < < . . , 19 

1 ,6 Starring ihe Windows Demo Application , ,24 



1.2 Introduction 



This section describes the connection and startup of the USB 08 
(universal serial bus) evaluation board demo application The main 
component of the USB08 is the Motorola MC68HC908JB8 8-bit 
microcontroller (MCU). 



1.3 Required System Configuration 



To connect lheUSB08 ( you will need a personal computer (PC) with one 
ol the following Microsoft operating systems: 



• Windows* 98 



• Windows ME 

• Windows 2000 Professional 



NO TE: Ensure that the PC has the necessary hardware (universal serial bus 
(USB) host controller and USB root hub) and that the necessary system 
drivers are Installed. 



Microsoft and W widows ore registered irademaffrs ol Microsoft Corporation in tie Uni led States 
and 'or o tier cowtiries. 
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USB08 Quick Start 



1.4 Connecting the Demo Board to the PC 



Since low-speed USB devices should be equipped with a captive 
connection, the USB cable is fixed on the USB08 board (downstream 
direction). In the upstream direction {PC/host side), the USB 
connections are always type A. Therefore, the cable ot the USB08 demo 
board has a type A plug. 

The connection of the cfemo board is made directly to the USB socket ot 
the PC or. as shown in the Figure 1-1. to a USB hub. 




Figure 1-1. Demo Board Connected to the USB Hub 

The board supply current can be delivered by the USB connection- 
Therefore, the jumper JP2. which is directly beside the USB cable, has 
to be in the position Bus Powered. The jumper JP1-A (jumper block, 
highest position) must be opened, which corresponds to the default 
shipping configuration. 



Designer Reference Manual 



USBOE Evaluation Board 



USB06 Quick Start 



MOTOROLA 



US BOS Quick Start 
Driver Insiallaion 



1.3 Driver Installation 



For this example, the installation ot the driver software is described using 
the Windows 2000 operating system The Installation using Windows 96 
(second edition) looks quite similar 

After the electrical connection of the demo board, the Windows 
operating system recognizes the presence of o new hardware 
component and shows the message Found New Hardware 



Found r*ew Hardware 



535 



U^LitíEvabáioríSoaiá 



Figure 1-2. Found New Hardware Screen 
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USB08 Quick Start 



The hardware assistant, Figure 1-3. now tries to find the suitable driver 
information tor the USB08 evaluation board Click the Next button. 

NOTE; The installation using the Windows 2000 operating system requires 
administrator rights. 



r mil iii Nrw tbiiiliurir*' WtirtMl 




Welcome to the Found New 
Hardware Wizard 

7 p i: a* : 3*tJ top: voj h$ú\ a 6z /i:o divoi lot o 



1 l ccftriue Uc' Ntfl 



5^-1 | h«ai ■ j 



t*»L* 



Figure 1-3. Found New Hardware Wizard Start Screen 
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USBOS Quick Slarl 
Driver Insiallaton 



Insert the USBOS product CD into the CD-ROM drive and mark the 
appropriate check box CD-ROM drives as shown in Figure 1-4. Click 
the Next button. 



■ 



frnjuil ^c" ItarihMore WL;af d 



Wbore dp you v ail vtafr^ to ia^ch ?:i cttfocr f le*? 



ittrchfiudthtei 'Jet <rr »* irlburg to4w«e tfcuCr 




1 lev^id^^'rt ío ftilábJ&dwttit h ii? J*rv« dáãban* cri jjh ccropjta aid b 
flry cf tin IcribMrq rptond stanch irjcMnrm Itoticu Amcfy, 

ToawiteÂwKcIdtticxi l^uft'Q'WciViQ&tofViaiddi cr CD-ROM cNt 
ítiiwl Uts Happy dn^ci Q) betae ckh*q Heft) 

OgOjiúUtaiLti ò^Actn; 

r Fbawdiafcdíf^í 

I* ClMTOM*>w 



Car 



Figure 1*4. Locale Driver Files Screen 
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U5B06 Quick Start 



As shown In Figure 1-5, the hardware assistant will find the driver 
information lite usbro_eUnf in the root directory ot the CD ROM. Confirm 
this selection by clicking Next 



ruuutJNrw lUul*wr WLinI 



UrtVpf Filet Í>pohÍi I 3r.»jÍl r . 

Jtcnastú lis i tnnhrd tetichruiHi diivc fiei fai yoji hadnnip b;vce 




T Ik ni^JbirSs <±r**r foi <h» klt^rrj d?*ii* 



£ p U 5 E03 Evaljcb'cr i Bo=»d 



IAiaIil clftl 




Figure 1-5. Driver Flies Search Results Screen 
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US B06 Quick Start 
Driyer Imiallaton 



The Windows operating system now copies the INF file and lhe driver file 
U5bfc>_el.syB to the appropriate Windows directories After clicking 
Finish (Figure 1-6), the driver installation will be completed and the 
USB device will be ready lor use. 



f fiijnfl Ntw Hotifwnrc Vftmd 




Completing the Found New 
Hardware Wizard 

A U5BIErT*4lirfonEc»id 



Wirdrm has tiwltftj rotalng lhe wlrvwrc ror flu dev 



n 



TnticcelrH?"&Trl4rl> Fnsh 



Rrtth 



■ 



Figure 1-6, Found New Hardware Wizard Finish Screen 

NO TE: The tnstailútion does not require a restart ot the computer, since this is 
a true Plug S Ploy installation. 
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U5B06 Quick Start 



1.6 Starting the Windows Demo Application 

The windows demo application: 



Shows the measured values and push button information coming 
from the demo board 

• Allows the controlling of the demo board light-emitting diodes 
(LED) 

The demo application is located in the root directory of the USB08 
product CD, The file name of the demo applcation is IO0BUSB.EXE. 
This program can be started directly from the CD. 



IODK (USB] 



ZJ3 



Digte Inputs— 


I 


Ooiiallnputl 


m 


Dotal Input 2 


# 


DgiiallriptitS 
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btpWtliipiJUl 



r DtgldfUJputg 



r DigtdOUpjt3 



rAndcg Inpja 





AnSoq Inpu 1 Analoglrpui2 ftnaoghpui; 
1 Hadvaro found 



_ 



Figure 1-7. Windows Demo Application IO08USB 

As shown in Figure 1-7* the bottom lineof the application window shows 
the status ol the connection established to the USB08 demo board. The 
LED symbols on the left upper side of the application window can be 
switched on or oft by pressing the keys of the USBOSdemo board. 
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Star trig Ite Windows Demo Appticaiion 



By selling Ihe check boxes on lhe upper nght side rl is possible lo switch 
on or oft the LEDsot lhe demo board. The needle poinler instruments on 
the lower sdeot the application window indicate the measured valuss of 
the three variable resistors: 

• Input 1 represents lhe photo sensor. 

• Input 2 shows the thermistor value, 

- Input 3 can be varied using the turnable regulator. 

The U SB 08 evaluation board can be disconnected fium the U SB port 
end reconnected at an/ time, because the drivers are automatically 
activated or deactivated by the Windows operating system The 
activation/deactrvationof the drivers can be watched in the operating 
system's device manager window (start button/settings/control panel' 
system/device manager). The catalog entry USBIO controlled devices 
and the device entry US8D8 Evaluation Board are visible only it the 
hardware is present See Figure 1-8, 



WOrwr MflfurçCT 
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Figure 1-8. Driver Entry lor USB08 in the Device Manager Window 
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USB08 Quick Start 



The Windows demo application. IO08USB.EXE, must be re-started in 
the case of a hardware connection interrupt. This is because an 
automatic re synchronization (though it would be possible) was not 
implemented here. The demo applcation is arranged as simply and as 
understandable as possible. 
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2.2 Introduction 
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The USB 08 evaluation board is the hardware platform for the universal 
serial bus (USB) reference design. The board serves the provided demo 
application, which is contained in the integrated FLASH memory ol the 
M68HC08 microcontroller (MCU). 
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Hardware Description 



Beyond thai, the USB08 enables the implementation and testing of its 
own M68HC08 software for evaluation purposes. For that purpose, the 
board contains a monitor mode interface for reprogramming and 
debugging. The monitor mode interlace of the USB08 is compatible with 
Motorola development tools such as the M68ICS08JB8 and other 
third-party tools. 



2.3 Technical Data 



This subsection provides techncal data for both the MC68HC908JB8 
and the USB08 evaluation board. 



2.3.1 MC68HC9Q8JB8 Microcontroller 



The main component of the USB08 evaluation board is the 
MC68HC908JB8. a Motorola 8-bit MCU. Features of the 
MC68HC908JB8 include: 

Efficient M68HC08 MCU core 

8 Kbytes of on-chip FLASH memory with security feature 

256 bytes of random-access memory (BAM) 

3-MHz bus clock (6-MH z quartz crystal) 

2 x 16-bit timer with; 

— Inputcapture 

— Output compare 

— Pulse-width modulator (PWM) 
Low-speed USB 1.1 interface module 
Integrated 3-V voltage regulator 
Computer operating properly (COP) watchdog timer 
Low-voltage interrupt (LVI) reset controller 



Inputs for BESET and IBQ pins 
Up to 21 input-output (I/O) lines 
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23.2 USB08 Evaluation Board 

Features of the USB08 evaluation board include: 

- M68HC908JB8 MCU packaged in o 28-pin smalhoulline 
integrated circuit package (SOIC) 

• Three light-emitting diodes (LED) 
■ Three input keys 

• Three analog sensors: 

— Light 

— Temperature 

— Angle of rotation 

Current supplied alternatively via USB connection or on-board 
voltage regulator 

Monitor mode interlace for irr-system programming and debugging 

AddrfOnal RS232 interface for connection to PC or serial liquid 
crystal display (LCD) 

Push buttons for reset and IRQ 

Jumper for power-on reset (POR) 

All MCU pins are accessible via a 26-pin universal expansion 
connector 

• Small user breadboard area reserved for customer circuit 
extensions 

The USB08 evaluation board is shown in Figure 2-1. 
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Figure 2*1. USBOB Evaluation Board 



2.4 Circuit Description 



A schematic ol the USB08 demo board is provided In Appendix D. Bill 
of Materials and Schematic The MC68HC90BJB8 MCU needs few 
external elements. A wide range ol peripheral functions Including the 
USB module and an S-Kbyte FLASH memory are Inlegraled on-chip. 
The MC68HC908J88 is offered in several packages. For lhe USB08 
reference design, the 28-pin SOIC version was chosen instead ol the 
20-pin dual In-line package (DIP) because the SOIC package has some 
additional I/O pins. 
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2,4.1 MCU Core Circuit and USB Interlace 



The operating voltage. Vdd- ' s supported by the capacitors C6 and C3 
close to the MCU. Out of this primary operating voltage ot approximately 
5 V, the MCU produces an internal operating voltage. Vreg* of 3.3 V. 
using an integrated voltage regulator This voltags is supported by two 
capacitors. C4 and C5. and continues in the circuit as V cc . 

In particular, the internal voltage Vcc^Vreg is used as the USB interface 
driver voltage supply. V CC /V REG is accessible over the expansion plug 

connector XL However, it must be noted that Vcc^Vreg ca* 1 be 

additionally loaded only with a tew milllamps 

Forelock generation, the external elementsOl. Cl. C2, andR18are 
used. These elements form a Perce oscillator together with the active 
elements integrated in the MCU. This oscillator produces a ctock 
frequency of 6 MHz. The internal buscbekof the MCU (3 MHz) as well 
as the USB clock (1.5 MHz) are derived (rom the main ctock frequency. 

The USB data lines are connected to the MCU pins PTE3 (USB D+) and 
PTE4 (USB D-). So that the USB hub will be able to classify this 
equipment as a low-speed USB device, a pullup resistance of 1 .5 KÍ1 
(R7) to the data line D- is required. 

On the demo board, R7 is not installed. This is because the 
MC67HC908JB8has an additbnal internal pullup at PTE4 which can be 
activated and de-activated by software. 

To optimize the connection adjustment, the serial resistors in the data 
lines R16 and R17and inductances (ferrite beads) in the current supply 
path LI and L2 are used. However, these measures are optional. 

The reset system of the M68HC08 shows clear differences from other 
Motorola MCUs (M68HC1 1 and M68HC12). Forexample, the capacitor 
C19 at the reset pin of this circuit could never be used in an M68HC1 1 
system. This is because the MC68HC908JB8 has an integrated 
low-voltage inhibit (LVI) circuit. Therefore, ro external reset controller is 
required. 
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2.4.2 Input/Output Functions 

For demonstration purposes, the board has: 

■ Three push buttons 

- Three light-emitting diodes (LED) 

■ Sensor resistors 

The push buttons are connected to the three port pins PTA4. PTA5. and 
PTA6. By pushing the buttons, a low level is produced on the appropriate 
input, Since the port pins have internal pullup resistors, no external 
resistors are required. The buttons are bridged with capacitors, to 
support correct reading of the inputs by the software and to avoid noise. 
The occurrence of the high-low edge at therespeclivepinof port A is an 
input event which results in the generation of a keyboard interrupt by the 
MC68HC0BJB8. This interrupt is then used by the program (see 
Section 3. Software Module Descriptions), 

Foroptical signalling, three LEDs are attached to port D. These port pins 
have a high drive capability of up to 25 mA. Therefore, It is not necessary 
to use a driver On the board, PTDO. PTD1. and PTD2 are used tor LED 
control. All outputs generated by the port D pins have an open-dram 
characteristic and are 5-V tolerant* 

The remaining port D pins (PTD3— PTD6) are used for controlling the 
software anabg-to-digilal converter (ADC). The ADC implementation is 
described in detail in Section 3. Software Module Descriptions as well 
as in the application note emitted Simple A/D for MCUs without Built-in 
A/D Converters* Motorola document order number AN477/D. This 
application note can be found on the World Wide Web at: 
httpy/wwwmotorolacom/ semiconductors/ 

The software ADC senses the resistance of: 

■ Rl (pholo resistor) 

• H2 (thermistor) 

• H3 (potentiometer) 

To determine capacitor load times, the MCU pins PTEO— PTE2 serve as 
trigger inputs tor the software ADC. 
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NOTE: 



The I/O pins ol the MCU are accessible on the expansion connector XI 
User specific peripheral circuits can be attached to Xi 

It may be that not all functions of the demo board may be used with 
user-specific peripheral circuits attached to X1. 



2.4.3 Monitor Mode Interface 



For FLASH programming and software debugging, the MC66HC908JB8 
uses a special operating mode, monitor mode The difference between 
monitor mode and normal user mode is that firmwareou! of the read-only 
memory (FIOM) Is executed instead of the user program. First this 
firmware examines asetot lOpins and specifies the concrete operating 
parameters. Finally, this firmware establishes an asynchronous senal 
interface function on the port pin PTA0 + This interface works 
bid i lection ally (half duplex) and corresponds to the usual RS232 
conventions. The baud rate equals 9600 baud. An additional 
requirement, besides the quartz clock (6 MHz), is the allocation of 
certain logic levels to some pod pins as listed in Table 2-1. 

Table 2-1. Port A Monitor Mode Entry Levels 



Pari Pin 


Level 




PTAO 


High 




PTÀ1 


High 




PTA2 


Low 




FTA3 


High 





The monitor mocte circuitry on the evaluation board produces the levels 
shown in Table 2-1 using four pullup or pulldown resistors. These 
resistors are connected to the MCU using the jumpers JP1-G-JPI-F. 
After removing these jumpers, a previously loaded user program can 
access the four port A pins without restrictions. 

Apart from the above require ments. to enter monitor mode rt is 



necessary to apply a voltage of approximately 7—10 v to the IRQ pin of 
the MCU, This voltage is generated by the RS232 transceiver's (IC2) 
charge pump and limrted to B 2 V using the breakdown diode D7 JP1-A 
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is the first jumper of !he jumper blocK JP1. and it must be sel in order to 
apply high voltage to IRQ. 

If the monitor mode Interlace Is nol needed or il It disturbs the 
investigation of certain circuit configurations. K can be uncoupled 
completely from the MCU core. For this purpose: 

• All jumpers of jumper blocKJPl have lo be removed. 

■ RS232 receiver IC2 has to be removed from the socket 

Using the X2 plug connector, the monitor mode Inlerlace Is connected to 
the PC. The monitor mode cable consists of: 

■ A flatcabte with a Berg connector (2x5 pin, crimping connection) 
on the device side 

* A sub-D9 connector (crimping connecton) on the PC side 

A one-lo-one connection is implemented by this cable configuration, as 
shown in Table 2-2. 



Table 2-2. Monitor Mode Cable Pin Configuration 



XaPin 


US BOG Monitor 


PC RS232 


Sub-0 9 Pin 




3 


TIOUT 


RiO 


2 




5 


RUN 


1x0 


3 




g 


GND 


GND 


5 





The MG68HC9D8JB8 logic levels are based on the operating voltage 
V cc (3.3 V); however, the transceiver IC2 works with V DD (5 V). The 
adjustment of tte logic levels according to specification is not difficult 
(refer to the Individual Integrated circuit data sheets), The Schotthy 
diode, D6. enabtes the push/pull exit RTOUT to be wired-OB capable 
and prevents a feeding of levels beyond the tolerance limit of the input 
PTAO, 
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2.4,4 UserRS232 Port 



The monitor mode interface uses only one sending'receiving channel of 
the RS232 transceiver IC2, The remaining channel (s used for an 
Jitional user HS232 port 



In contrast to the RS232 channel lor the monitor mode interlace, the user 
RS232 port incorporates separate sending and receiving lines. The 
PTA7 pin ot the MCU is used for receiving and the PTCO pin is used for 
sending, 

NOTE: The MC68HC908JB8 does not have a serial communications interface 
(SCI) hardware module for asynchronous serial communication. 
Therefore, the necessary timing has to be generated by software 

If PTA7 anchor PTCO are to be used, the dode D5 serves for the 
adjustment of the logic levels between 5 V and 3 V. Otherwise, the 
RS232 transceiver can be uncoupled from the MCU by removing the 
jumpers JP1-G and JP1-H 

X3 is the user RS232 port plug connector. If this interface is attached to 
a PC r a line connection similar to the monitor mode interlace Is 
necessary. In this case, the bridges 8RI and BR2 on the downside of 
the printed circuit board (PCB) (see Figure 2-3) have to be connected in 
positions 1 and 2. For this configuration, the PC works as a host and the 
USB 08 board represents the device side. 

The reverse case happens, if a serial liquid crystal display (LCD) is to be 
operated at the user RS232 port. In this configuration, the USB08 board 
is the host and the LCD module represents the device side. The 
necessary FtaD-TxD crossing is done by configuration of the bridges 
BR1 and BR2 in positions 2 and 3 At the same time, the serial LCD can 
be supplied with operating voltage by closing the bridge BR3, 

NO TE: This specification deviates from standard RS232 mapping. 

Serial alphanumeric LCDs are offered by several vendors. In the test 
configuration, tfe LCDs used are from the Canadian manufacturer 
Matrix Orbital (http://www.rn at rixorbilal, com). 
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2,4.5 Power Supply 



Power can be suppled to the USBOB board by using the USB orvia the 
voltage regulator IC3. The change between these options Is done by 
replacing lhe jumper JP2. If the jumper is placed in position 2—3 (Bus 
Powered), the operating power is supplied by V&j S and Vquq from the 
USB. 

II a dc voltage between 8 V and 20 V is fed into the power plug X4 in 
jumper position i -2 'Self Powered) the voltage regulator IC3 supplies 
5 V in the case. The solder bridge BR4 on the downside of the PCB (see 
Figure 2-3) has to be in position 1-2 Alternatively, if the bridge 8H4 is 
in position 2—3. a stabilized 5-V power supply can be used to feed Vqjj 
directly. 

The voltage regulator IC3 is specified with 1 ampere Although no 
special cooling measures are intended. IC3 is more than sufficiently 
dimensioned. The input current of the board, even in the worst case, is 
clearly smaller than 1 00 mA. 

A USB hub supples at least 100 mA Therefore, the power supply ol the 
board via the USB is possible without any problem. The USB09 board 
power input specification should be legistered in the device descriptor of 
the USB device (see Section 4. Universal Serial Bus (USB) interface) 



2.5 Board Layout 

Figure 2-2 and Figure 2-3 show the components and parts layout» as 
well as a general picture ol the board. 

On the component side» Figure 2-2; 

- The jumpers, plugs, push buttons» and LEDs are marked» 

- The USB cable is fixed on the board with acabte strap, and lhe 
four line ends are soldered directly to the X5 connection points 
(without palch corcl). This hind of connection Is usual for 
low-speed USB devices. 

A detailed layout plan of the USB08 board with the names ol all 
components is shown in Figure 2-3. 
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Figure 2-2, PCB Component Skie Layout Plan 
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Figure 2-3. Detailed Layout Plan 
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2.0 Jumpers and Bridges 

The jumper configuration is shown in Table 2-3. 

Table 2-3. Jumper Configuration 



Jumper 


Poirtmn< a > 


Function 




JP1-A 


Open* 


Normal user mocfc 




Closed 


High voltage on IRQ to enter monitor mode 




JP1-B 


Open 


R5232rsdscomecledfrom lhe power supply. 




Closed" 


R5232 is connected to lhe power supply. 




JP1-C 


Open 


PTAO can be used without restriction. 




Close d* 


PTAO is used lor monitor mode communication. 




JPt-D 


Open 


PTA1 can be used without restriction. 




Closed* 


PTA1 is used lex monitor mode configuration 




JP1-E 


Open 


PTA2 can be used without restriction. 




Closed* 


PTA2 is used Ice monitor mode con* gj ration 




JP1-F 


Open 


PTA3 can be used without restriction. 




Closed* 


PTA3 is used lor monitor mode confguration. 




JP1-G 


Open 


PTA7 can be used without restriction. 




Closed* 


PTA7 serves as receivrig line tor lhe user R5232. 




JP1-H 


Open 


PICO can be used without res ticfon. 




Closed* 


PTCO serves as transmission line Ice the user R5232. 




JP2 


1-2 


Sell-powered: power supply via voltage regulate* 




2-3* 


8us-powered: power supply via USB 





- deliver/ 



Placement of the solder bridges on the downside of the PCB is shown in 
Figure 2-4. Table 2-4 shows the solder bridges configuration. 
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Figure 2-4. Solder Bridge Placement 
on Downside of lhe PCB 

Table 2-4. Solder Bridges Configuration 



Solder 
Bridge 


Positional 


Function 




8R1 
and8R2 


1-2* 


User RS232 configured in externa! device mode (PC) 




2-3 


User RS232 configured in host mode (LCD connection) 




8R3 


Open- 


Vcc is not present at user RS232por1 (standard). 




Closed 


V cc is present al pin 9 olihe user RS232, 




8R4 


\ 2" 


Power supply via vollage regulator. 8-20 V needed ai X4 




2-3 


Power supply dree fly Irom X4 r musi be stabilized al 5 V 





a. * » delivery status 
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2.7 Connectors 



The connectors are described here. 



2,7.1 Expansion Connector X1 



-_{■' 



XI 



2.7.2 Monitor Mode Connector X2 



N.C. 

PC.RxD 

PCTxD 

ltd 

GHD 



'cc 



RTS 


DID 


PTAO 


PTDG 




PTA1 


PTD1 




PTA2 


PTD2 


DO 


PTA3 


PTD3 


oo 


PTA4 


PTD4 




PTAS 


PTD5 


BIO 


PTA6 


PTD6 


DO 


PTA7 


PTE3 


El 


PTEO 


PTE4 




FT El 


pica 




PTE2 


GHD 


Emnã 


GHD 



N.C. 
N.C. 



X2 
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2.7.3 User BS232 Connector X3 



Rx(Ti) 

Tx (Ri) 

N.C. 

GHD 



Voo 
ItC. 



X3 





Table 2-5. MC68HC908JBS Memory Map 


From 


To 


Size 


Content 


0x0000 


Ox003F 


G4by1es 


Control registers 


0x0040 


0-01 3F 


256 bytes 


RAM 


0x0140 


0x0 BFF 


— 


Reserved 


OxDCOO 


OxFBFF 


8 Kbytes 


FLASH memory 


OxFCDO 


OxFFDF 


— 


Reserved 


OxFFEO 


OxFFFF 


32 byles 


imerrupl vedo: íabie (FLASH) 



For a detailed description ol lhe MC68HC908JB8 memory map. in 
partcular the addresses ot control registers and interrupt vectors, refer 
to the MC68HC908JB8 Technical Data. Motorola document order 
number MC68HC9Q8J88/D. 
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3.2 Introduction 



Section 3. Software Module Descriptions 



35 Introduction, „ , ,„,..,..,„,„,..,..,„,„,.. ,43 

3.3 General Structure ol the M66HCD8 Firmware , »--•-- ,44 

3.4 How to Build The Compiler Project , .. , , .. , < -. ,45 

3.5 Main Module U08MAIMC 48 

3.6 Interrupt and Reset Vector Module VECJB8.C , „ , ...49 

3.7 C Startup Module CRTSJB8S » „ » a ■««■ ■ ■ ^fifl 

3,6 Push Button Modute U08KEY.C 50 

3.9 LED Control with U08LED.H , „ , , „ , , .. .52 

3.10 Software ADC Module U08ADC.C. , < 52 

3.11 RS232 Communication Module U08232.C »--<-- .54 

3.12 USB Communcation Module U08USB,C. ,„,„,„,„,„ .56 

3.13 Compiler Specric Adjustments* -.»--< < -- < ■ -. .57 



This section describes the structure end interaction ol the software 
modules. These software modules, running on the Motorola 
microcontroller MC68HC908J88. form the firmware of the US808 
reference design. 
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3.3 General Structure of the M08HCQ8 Firmware 



The firmware ol the M68HC0B consists of several source code modules 
which are embedded into a common compiler project The main(J 
[unction is contained in the module U05MAIN.C, It controls the program 
sequence via an endless loop (as usual in embedded software). The 
module U08KEY.C settles the scanning ot the input keys* Control of the 
light-emitting diodes (LED) on the board is done using simple C macros; 
no special C modute is required (or this purpose. The module 
U08ADC.C is responsible for reading of the resistive sensors. 

These modules are supported by the file VECJB8.C, which contains the 
interrupt and reset vectors. The four C source code modules are merged 
into a common compiler project In addition, the assembter module 
CRTSJBQS which contains the C startup code is required. 

The control of keys, LEDs. and analog- to-digital (A/D) transmitters are 
support functions to the demonstration project because the main 
attention is paid to the communication interface The communication 
functions are implemented directly by means of "tfinclude" instructions in 
the main module U08MÀIN.C. 

Two ways of communication are implemented in the demonstration: 
RS232 or USB The selection takes place by defining U9EJJSB_PIPE 
in the head of the main module. K this macro is defined, U08USB C 
automatically becomes apartol lhe main module; otherwise, the RS232 
communication module U08232.C is merged. 

|t the USB implementation in the file U08USB.C is used, the file 
U08DESC.C is also translated at the same time It contains the static 
data for all necessary USB descnptors. 

Foreachof the C files U08KEY.C. U08ADC.C, U08USB.C. and 
U08232.C there is a corresponding header tile (* H) with the same base 
name. The (unctions for controlling the LEDson lhe board are contained 
as macros fti the Hie U08LED.H In several cases, the header 
MC68HC0BJB8.H contains the register and bit maskdefinilions required 
by the MC68HC908JB8 microcontroller {MCU). 
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Figure 3-1 shows the structure and interacton of the modutes and fifes 
that could be Included by means of "ftnclude* instructions. To 
accomplish a complete compiler build, the grey modutes have to be 
included in a compiler project. 



3.4 How to Build the Compiler Project 



The Cosmic C Compilercan to arrange a project within the compter IDE. 
The compiler project owns: 

• A list ol source modules to be complied 



• Translation options 

■ Addltonal tools such as S-record generatOn 







Pfojeci Files 






- 




HC0HJB3 H 


CRTSJ83.S 
C-S t»lup MxmJuIt 








1KB MAIN C 
Um Modult 
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US8 Dtccripbrt 






^v ^^ 
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■ ^ 
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Figure 3-1 . Structure and Dependencies ot the Firmware Files 
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The compiler project (or the USB08 reference design covers these C 
modules (see Figure 3-1): 

- U08MAIN.C 

- U08KEY.C 

- U08ADC.C 
• VECJB8.C 

An alternative possibility consists of controlling the translaton of the 
project vra a batch file as shown in this example (BUILD. BAT). 






This batch file can be invoked under the MS-DOS system environment 
to translate and link USB08 firmware components. The result of this 
process is a S-tecord life named US808.S19. which can be loaded into 
the FLASH memory of the MC68HC906JB8. 

Another important fite for controlling the translation is the linker file 
USB08XKF: 

• :^&:e it!»* c<amtAMi> ft it 

• 

**^ff t tat *b Q^de40 *n -so»* V prcQifi* «vac* od4icr* 

• ■« i«Mt a .', «* • pCfk#**flt« ieiietf =CJ- 

*íçç * £>■<£ ~b QxOâ4â *n .Vtct V sro p«^r «cul id^(c«# 
*«v^ . iito*.*C *o - c nt *** -L*r-.ct # i^t o #ti/( *dac?#* 

Vdcl «fea**t -fa» * nut o4fir«t t b*r 

• í ^ i | mr . ' d : : l^ ill? bci? 
:r^!>»-c • Minai rMiíoç 

• rui i )t>r fi:u strc 



.117** T| . 
kfâflDdc.4 

•fc? . rin#t -E -*fífJ t itfiííJ «cart eddied* 

* ? jl ( mr ifilf? i -jpt itci j t * ! d ? Mtr * f ftpf Jed 



MS-DOS i-s 3 itgisipíríJ tadritiark ol Miatiaoil Gcvpcralun in t*ir Uri fed Stair t amicii d tier 
counwieG- 
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In the linker tile: 

• The starting addresses ol the various segments are set. 

• The text segment starts althe address OxDCOO (for example, at 
ths beginning of the internal FLASH memory). 

■ The constants immediately follow the text segment 

- The zero page starts al 0x0040 instead of the usual 0x0000 

- The MC68HC908JB8 control registers are located in the address 
range 0x0000-0x0040, 

• The data segment follows the zero page in the random-access 
memory (RAM). 

• The interrupt vectors start at OxFFFO and the stack pointer is set 
to 0x01 3F (end of the internal HAM memory). 

Table 3-1 shows the approximate values for memory utilization when 
USB communication has been implemented. 

Table 3-1. Memory Utilization 



Starting 
Addreis 


End 
Addrett 


Length 


Contents 




0x0000 


0xO03F 


S4byte 


MCSBHC908JBG control regsiere 




0*0040 


0x0075 


53 byte 


Variables in RAM 




0x0076 


0x0117 


163by1e 


Fie» RAM 




0x0119 


0x01 3F 


40 byte 


Stack in RAM 




OxDCOO 


0xE2FF 


T £ Kbyte 


Code and constam values 




Ox E 300 


OxFBFF 


6.2 Kbyte 


Free FLASH memory 




OxFFFO 


OxFFFF 


16byte 


Interrupt and reset vectors 
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3.5 Main Module U08MAIM.C 



Which variant to be compiled is specified at the head ol this module 
using the macro USEJJSB_PIPE. If defined, the USB version will be 
produced; otherwise, the RS232 version will be produced. 

The two versbns are formed by merging different '#include' files. In 
lition, the names ol the interface tunctions used in the main program 
standardized. For example: 

* It the RS232 version is active, the getSSCI() (for receiving a 
character via RS232) is renamed by a macro to getPipe(). 

* It the USB version is active. getPipe() is mapped to getUSBQ. 

This enables the use ot uniform tunction names in the main program, 
indepenctentof the version selected in each case. 

The function main() contains the continuDUS loop of the master program. 
As usual, it is called by the C startup module after all fundamental 
hardware and system initializations are finished. Also, at the beginning 
ot these initializations, the C startup module calls the functon 
_HC08Setup(). In this function, all register accesses and initializations, 
which must take place immediately after system resets, are 
summarized. The summarizing of these initializations within its own 
function Keeps the C startup module static. It has the advantage that the 
C startup module does not have to be changed and retranslated, even if 
further initialization steps become necessary. 

At the beginning of function main() the peripheral modules used by the 
program are initialized: 

* initPipeQ — communication module (RS232or USB) 

* initLEDO — LED readouts 

* initKeyO — keyboard entry 

* initSADCQ — software an a tog- to-digital converter (ADC) 
Subsequently, the I flag is deleted to enable gtobal interrupts. 
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The main program loop uses this operational sequence: 

1 L An analog-to-digit ai (A/D) conversion is performed. One ot three 
conversion channels is updated in each cycle run. This procedure 
was selected because the transformation, wtth the simple ADC 
software implemented in the module U08ADC.C. takes several 
milliseconds. 

ÍL Subsequently, the delivery of an 8-byte data telegram by the input 
pipe is accomplished This length was chosen because it 
corresponds to lhe number ol bytes sent by the PC program* 

The necessary intormatOn for the control of the three LEDs is 
contained in the first three bytes If the received byte is 0, the 
respective LED is switchsd off; otherwise, it is switched on 

3. To send ananswertetegram back at the host PC. tirstlill the send 
bufler utilizing the first six bytes of the eight byles available. In the 
ftrst three bytes, the slalus ol the Input keys is coded. The next 
three bytes transmit the last values of the three analog converter 
channels. 

4. Now the function putPipe{) is called eight limes to send the data 
telegram. Afterward, the entire cycle run is repeated 

All further program (unctions, in particular the communication via USB 
and the processing ot the push button events, are processed by interrupt 
functions. 



3.0 Interrupt and Reset Vector Module VECJB6.C 

The file VEC JBfl .C contains the definitions ot the interrupt vector table 
placed at the end ol the M68HC08 memory map. The entries in this table 
are the start addresses of the respective interrupt service routines. The 
MCG8HC908JB8 uses eight (7+ 1) vectors. The last, highest position 
(address OxFFFE/OxFFFF) is used by the reset vector 

In the USB08 reference design, the key pad interrupts of the input/output 
(I/O) port A are used as well as the USB interrupts incase the USB 
implementation was activated. The other interrupt vectors refer to an 
empty dummy interrupt service routine (ISR). This dummy ISR is 
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practically without function; however It con be used In the debugging 
phase for seeking out unexpected (spurious) interrupts In addition, the 
allocation of all interrupt vectors is important for the implementation of 
the FLASH memory secunty feature (read-out protection). For additional 
information, refer to the MC68HC908JB8 Technical Data. Motorola 
document order number MC68HC908JB8/D. 

The reset vector refers to the start address of Ihe application. This point 
of entrance is located in lhe C startup module. 



3.7 C Startup Module CRTSJB8.S 



The C startup module used essentially corresponds to the standard 
startup module from the Cosmic C Compiler package with one 
exception Immediately after a reset (and after Ihe initialization of the 
stack pointer), a subroutine reference was inserted to_HC08Setup(), 
This subfunction is defined in U08MAIN.C and performs urgent 
accesses to M68HC06 control registers which should be completed 
immediately after the reset 



3.8 Push Button Module UQ8KEY.C 



Port A (PTA) of lhe MC68HC908JB8 has eight port bits for keyboard 
connection- Each of these lines can cause an interrupt* The port bits 
individually can be configured for use within the MC6BHC908JB8 
keyboard interrupt module (KBI). 

The USB 08 evaluation board uses three single keys which are 
connected to port lines PTA[4;6] The switch noise reduction is 
performed via a resistor-capacitor (RCJ combination at each key. This 
combination is made by: 

- M68HC0B internal pullup resistors and a capacitor (parallel to the 
Key) 

• Hysteresis of the port A input Schmitt triggers 
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The KBI module ot the MC68HC908JB8 greatly simplifies the scanning 
ot the attached buttons. The software necessary for this takes only 20 
lines ot Ccode. 

The conditions are created in the initialization function initKey(). First the 
internal pullup resistors at the port A pins are activated. A short pulse of 
an active H level is driven at the port A pins which accelerates the rising 
of the togic levels at these pins. This prevents a false reading of the initial 
low level on the lines. 

The initialization function ends with the resetting of the status variable. 
KeyState. and the enabling of the keyboard interrupt 

During the manipulation of a key. the interrupt sen/ice routine isrKeyQ is 
called At port A, the pressed key is seen as a bit. The appropriate bit 
location is set accordingly in the status variable KeyState. By activation 
of a key the key status is inverted. This implementation simulates an 
on'off push button. 

If the main program wants to know the current status of a key (onfoff), it 
uses the access function getKey(). The number of the key (1...) will be 
handed over as a function argument. The function getKeyf) calculates a 
bit mask for access to an individual bit of the (internal) status variable 
KeyState. The return value amounts to 0, if the key is off; otherwise, a 1 
is returned. 

This module provides an easy way to specify the desired number of 
possible keys. For this purpose, two macros are used. KEY_MASK 
defines the used lines of port A by setting a 'one* flag at the appropriate 
bit location The macro KEY_FIRST defines at which bit location the first 
key is attached. Some examples: 



KEY_HASK" Oh Oi ; 
KKr_MA SIC* Ch 03 ; 
KKf_KArit p OxQO; 
KKr_HACK* Oh TO ; 
K KY _M A S K ■ Oh t O ; 
KIEr_KA.SK" Ox VIT ; 



rcY_ffTH5r-Dí 
tfJEY^tf msr*a ; 
iiCY_if iitsr*7f 

KtiY_!f insr*Of 



»n^ ke v at ?TA|0 | 
anei key at rCAll J 
!in^*— y *t ITAp ( 
three *-yx at rrA<<..« 

icii Kcyi at. PTAM..? 
= i-1h! kryv at rrfi[-:..'. 



The port bits included in the key scan have to follow one after another. 
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NO TE: It has to be pointed out for completeness, that with the KBI module otthe 
MC6BHC90BJB8 not only single keys but also extensive key fields m 
matrix arrangement can be easily scanned. 



3.9 LED Control with U08LED.H 

Controlling lhe three light- emitting diodes (LED) attached lo port D Is 
easy. For initialization, the data direction of the used port pins PTD[0.,2] 
has to be switched to on output state. The initialization as well as lhe 
switching of the LEDs is performed via four macros. Therefore, a header 
file is enough for lhe realization of these functions. A special C module 
Is not required In this case. 

The LEDs are addressed, beginning with a 1 . The switching on of the 
first LED <at PTD[0]) lakes place, for example, by means of: 
onLED(l); 



3,10 Software ADC Module U08ADC.C 

Although the MC68HC908JB8 does not have an integrated ADC, it is 
nevertheless possible to measure analog values (and in particular 
resistance values) m a simple way. For this purpose, an Recombination 
is attached to a conventional digital port pin and the load time of lhe 
capacitor is measured The working principle Is shown in Figure 3-2 




Figure 3^2. Measurement of Resistor Values Using a Digital Input 
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First, the switch S is closed and the capacitor C uncharged As soon os 
the switch S is opened, the charging procedure begins. The voltage at 
the input E of the microcontroller rises according to Ihe exponenlial 
(unction; 

U E ílí=V C c(l-e H:RC ') 

The threshold voltage at the input pin ol the MC68HC908JB8, Irom 
which a level change from low to high takes place, is approximately 
50 percent of (he operating voltage Vqc* Until this threshold is reacted, 
the loading time. Ix. amounts to: 
t 4 =K * R,C with K-0,7 torVcc'2 

Since h represents a constant value (In the considered short time trame), 
a linear connection between the measured lime and the producl RxC 
appears. Since C is constant, one can draw a direct conclusion from the 
charge time to the value ot the resistance Rx, 

To determine the absolute resistance of Rx. first the value ol the capacity 
C and the constant Khave to be determined. However, that is not 
econom cal( particularly with series products having acertain distribution 
ot its value). Instead, one can accomplish a calibration cycle before the 
actual measurement. This calibration cycle uses a reference resistance 
value R0 and determines the time 10. Ths following measure cycle uses 
series connection Rx* consisting of the reference resistance R0 and the 
variable resistance Rl (for example. RX =R0 + Rl). to determine the 
time tx. The result can be calculated using the relationship. 

The range of values of the result is between and I, if Rlmax = R0. 

The software ADC module of lhe USBD8 application serves three A^D 
channels (see Section 2- Hardware Description) Reaching the 
threshold voltage is sensed via the port pins PTE[6\,2j. Tte switch 
function forcharging.'dischargtng the capacitor is realized by switching 
the port pins as outputs In contrast to the circuit diagram (Figure 3-1). 
the polarity is exchanged (for instance, the point of reference is Vcc 
instead of ground) and the charge ol the capacitor is made by activating 



USB08 Evaluation Board Designer Reference Manual 

MOTOROLA Soltivare Module Descriptions 53 



Software Module Descriptions 



the ground potential at the resistors via the port pins PTDp..5] 
(calibration cycle) and PTD[6] (measunng cycle). 

Before the software ot lhe ADC modute con be used, the initialization 
function initSADCQ has to be called In addition, the main timer is 
required to run with 3 MHz (prescaler 0). The clocking of three impulses 
per microsecond is the basis of the lime measurement in this module. 

The function responsible for lhe A/D conversion of one channel ai a time 
Is getSADCQ. The channel number (1., 3) is handled as a parameter. 
The A'D conversion is performed in the two mentioned steps: calibration 
and measurement. 

The desired 8-bi! range for the results (values of 0...255) is a result of 
scaling of the A/D output Inoiderto keep the run time of lhe necessary 
division and multiplication operations small, the scaling function is 
implemented using some in-line assembler directives, 

A detailed discussion of the software A/D converter used here is 
contained in the application note entitled Simple A/D (or MCUs without 
Built-in A'D Converters, Motorola document order number AN477/D. 
This application note can be found on the World Wide Web at; 

http jVwww motorolacom/semiconduc tors/ 



3,11 RS232 Communication Module U08232-C 

The RS232 communication module performs the sending and the 
receiving ol data lo lhe host PC. The RS232 implementation is one of lhe 
two possible alternatives. By the ctefinihon of lhe macro 
USE_USB_PIPE m the main module U08MAIN.C, it is possible© switch 
from the RS232 version lo the USB version of the communication 
module. 

Since the MC68HC908JB8 does not have a hardware serial 
communications interface (SCI) peripheral module, an RS232 
transceiver has to be implemented by a software- based SCI module 
Two general- purpose I/O pins are used as receiving and transmission 
lines. The liming necessary for the desired baud rale is derived from a 
time loop. 
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The module contains these three Interface functions: 

initSSCI() — initialization ot the software SCI module 
getSSCIQ — receiving of a character 
puts S CI () — transmission of a character 

The module initialization function initSSCI() sets the data direction 
registers for the output and input port Before this setting, a 1 Is written 
to the data registerof the transmission line so that the output value of 
this line is the standard high state. 

The receive functton getSSCIQ waits until the state of the receiving line 
changes to low. This indicates the beginning of the start bKof an arriving 
byte. The following eight data bits are scanned suitably* in each case in 
thecenterof the bK time. The result of this scanning is finally returned to 
the calling function. 

The available implementation does not examine whether the arriving 
stop bit shows incorrect low levels (framing error) Also r an over 
scanning for the purpose of noise reduction does not lake place. 

The production of the bit rate is controlled by the module- internal 
function ctelayHallBrt(). The lunction is implemented with help from some 
in-line assembly code to ensure an accurate time performance, which 
can be simply changed by the user if necessary. The possible changes 
necessary for the adjustment to different baud rates is documented in 
the source text on the basis of two examples. 

Adjustments regarding the port pins used as sending or receiving lines 
are easily possible. The module uses five macros for the control and 
scanning in of these pins. These macros are defined in the head ot the 
file U08232.C. Almost all port pins can be used for the software serial 
communications interface (SCI) module by changing the bit masks 
and/or the port designators in these macros. 

In this demo application, the moderate baud rate of 2400 baud is 
selected An increase to 9600 baud is possible, but tests first must show 
that tre application runs without problems. It has to be taken into account 
that ths bit rate production is determined by a certain number of 
execution cycles by the central processor unit (CPU), which temporarily 
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disables any interrupts. Also. In an application wrth permanent interrupt 
use. the software SCt should run in an interrupt-con trolled way. Since 
the receiving ol a character is performed using port pin PTA7. the use of 
the keyboard Interrupt associated with this pin would be possible for the 
recognition of the start bit The timing for the scanning of the following 
received data bits could be made using the available main timer (TIM) of 
the MC68HC908JB8 as well as the sending of characters using the 
PTCO pin. 



3.12 USB Communication Module U08USB.C 



The USB communication module U08USB-C demonstrates how data 
can be exchanged between the microcontroller and host PC over an 
USB connection- This module can be linKed (alternatively lo lhe RS232 
communication module U0B232.C) into the USB08 application when the 
macro USE_USB_PIPE in the main module UOOMAJN is activated. 

Just like RS232. the USB uses serial streams tor lhe data 
communication. The substantially more complex operational sequence 
ol the USB can be encapsulated so that the integration into existing 
projects is possible without problems Therefore, the USB 
implementation shown here is Just as simple to manage for the firmware 
programmer as the classical RS232 version- Only three interface 
functions are needed; 

initU SB() — initialization of the U SB communication module 

getUSBQ — receiving acharacter 

putUSBQ — transmitting acharacter 

The integrated USB peripheral module of the MC68HC908JB8 is 
controlled using some control registers within the address range ol 
0x020 to 0x03F; the function initUSB)) takes care of the initialization of 
these registers, In addition, the status ol the USB equipment is set to the 
initial status (Powered) and the two software buffers whch buffer the 
sending anchor the receiving of data in the application are initialized. 

If data should be received, the routine gelUSB() is called by the 
application. First this routine stays in a waiting loop until data from the 
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USB peripheral modute arrives. As soon as thedatahas arrived, lhe next 
character is taken from the buffer and the read index Is Incremented* 
Since we are dealing with a ring butter. Ihis index. II it overflows beyond 
the upper butter border, is set back lo the lower buffer border {index 0). 

The size of the receiving ring buffer is specified by the macro 
MAX_RXBUF_SIZE. The selected value has to be a power-of-two 
number 

The transmission function putUSB{) uses another butter area which ia 
independent of the receive buffer including index variables tor read and 
write access. Again, the buffer size is specified using a macro 
(MAX_TXBUF_SlZE). Concerning the size, the restriclbn on 
power-of-two numbers applies here as well 

The character handed over to putUSBQ is placed into the buffer. It the 
buffer is full the routine waits until the send buffer again is able to store 
dafa. Afier placing the character into the send buffer, the access index 
variable is updated. 

Interrupt-controlled implementation of these functions is performed in 
the background of the microcontroller application: 

• Filling of the receive buffer 

• Sending of the characters in the send buffer via the USB 

For this purpose, an interrupt-controlled USB handler was implemented 
and can be used In many other applications without any changes. The 
principle ol operation and the places of possible or necessary 
modifications are described in detail In Section 4. Universal Serial Bus 
(USB) Interface 



3.13 Compiler Specific Adjustments 



The source text modules were written and translated with the M68HC08 
Cosmic C Compiler. This compiler supports the complete language 
scope available for ANSI-C. The porting of the firmware to another 
M68HC08 ANSI-C compiler should be possible without any problems, 
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because this application does not use problematic constructions, like bit 
fields in the source code. 

In some places, using individual assembler instructions in the form of 
in-line assembler directives is considered useful, for example, for the 
inierrupt enable in the main module UOBMAIN.C For this purpose, the 
Cosmic C Compiler oilers the following instruction. 

_asm("<assembly statement >"); 

When using other compilers, similar instructions should be available. 
However some small syntactic adjustments can be necessary. Beside 
the main module, the modules U08232.C and U08ADCC also contain 
such in-line assembler constructions. 

The marking ol a function as an interrupt service routine is not regulated 
in the ANSI-C standard. For lack of a uniform regulation, the different 
compilers handle this necessary marking in a different way For 
example, the Cosmic C Compiler uses the modification (©interrupt: 

^interrupt void interrupt_handler(); 
Other compilers use-#pragma f instructions to mark interrupt functions. 
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Section 4. Universal Serial Bus (USB) Interface 
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4.2 Introduction 
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The universal serial bus (USB) Is an interface for the connection of 
peripheral devices, for example, printers, scanners, keyboards, and 
pointing devices lo a PC or a similar host. 
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The USB specification*'' whichcan be lound on the World Wide Web at: 

http://www.usb.org 

is an industry standard, which exactly defines this bus system beginning 
with the electrical interface up to the higher protocol layers to guarantee 
the inter-operabilityot all the different devices. A simple way of handling 
is the most important requirement for USB devices from the view of the 
user 

Several versions of the USB specification exist. Apart from the already 
established release 1.1, on which the MC68HC908JB8 and the available 
reference design is based, the specification 2.0 was compiled in the year 
2000 by the USB Implemented Forum (USB-IF). This versbn ensures 
compatibility to the versbn 1,1 and contains the already known speed 
classifications "low speed' and 'full speed'. Beyond that, release 2.0 
introduces a high-speed devce type. First high-speed devices are 
expected to be established in the market by end of the year 2001. 

The basic specification of the USB is supplemented by several class 
specifications for certain types of device classes, which can be found 
frequently (for example, human interface devce class for keyboards, 
mouse pointers, etc.). Further information regarding conditions and 
contents of basic and class specifcatcns can be found on the World 
Wide Web at: 

http://www.usb.org 



4.3 Characteristics of the USB08 Reference Design 



The USB08 reference design shows, via adetailed example, how the 
integrated USB module of the Motorola microcontroller unit (MCU) 
MC68HC908JB8 can be used. The MCU is used for a measuring and 
control application and exchanges data with a PC via the USB. This 
reference design shows that communication to a PC using USB can be 
just as simple as a normal RS232 link. 



1 . UnivcraJ Serial Buz Specificaton Revision 1 .1 : Sepirtnbet 23. II 
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The integrated USB module ol the MC68HC908JB8 worKs at a data rale 
ol 1.5 Mbit/s, thus it is defined as a tow-speed USB device. For 
measuring and control applications, typically only small data rates are 
needed, and this is already realized using low-speed USB devices. A 
tow-speed USB device ensures an information (low rate r which can be 
compared roughly with an RS232 link with 9600 baud. At tirst glance, 
that doesn't seem to be much; however, the USB variant offers a set ol 
other advantages 

White RS232 always represents point-to-point connection. USB 
supports a bus structure. The PC serves as bus master and several USB 
devices can be attached. If the connections (ports) at the PC (host) are 
not sufficient. USB hubs can be inserted. Hubs can be cascaded up to 
five levels. Each USB device is addressed by the host via a unique 
acMress. The address range supports up to 127 addresses. Thus, a 
whale measurement and recording system can be arranged easily using 
a dozen low-speed USB devices and two or three commercial hubs 

This reference design contains USB08 evaluation board firmware; 
therefore, this Plug & Play demo application can be evaluated 
immediately. Beyond that, all source code is provided in the form of C 
modules for the M68HC08 Cosmic C compiler. The usercan use these 
sources as a starting point for thejrown USB development. 

The most important modules for the USB implementation are the source 
code modules U08USB.C* U08DESC.C. and the headerfile U08USB.H 
(see Section 3. Software Module Descriptions) The USB functional 
description refers to these source code modules. 

Administration of the USB device takes the largest portion of the 
referenced implementation source code. This is done via so-called 
standard device service requests. These transfers take place via the 
control endpoint and are multi-tevel. complex communication 
procedures* Since the implementation ol these complex functions 
virtually can be transferred as a block from the reference design to any 
other application, the practical work for the administration of a USB 
device should not be overestimated. Simply, the actual data 
communication functions (which take place using the interrupt endpoints 
1 and 2) can be adapted to the concrete user application. 



US BOS Evaluation Board Designer Reference Manual 

MOTOROLA Universal Serial Bub (USB) Interlace 61 



Universal Serial Bus (USB) Interface 



4.4 USB Basics 



NOTE. 



Concerning the electrical interface, the plug and the cable, as well as 
questions on lhe bus topology we refer lo the Universal Serial Bus 
Specification Revision 1. 1 standard reference. The volume of 
Information contained in this specification exceeds by far this manual. 
Also some good introductions are offered by books, tor example the 
bookby Kelmf 1 ). 

Some terms and procedures from the USB specification, which are 
important for the implementation of the reference design, will be 
repeated here and described briefly. 

Packets form the basic modules of the USB communication in the levels 
above the electrical connection. Packets are atomic, for instance, they 
cannot be interrupted or divided into sections The packet types shown 
in Table 4-1 are relevant for low-speed USB. 

Table 4-1- Low-Speed USB Packet Types 



Nan* 


Group 


Function 




SETUP 


Token 


Starts a cont'd f arts ter 




IN 


Token 


Starts a data transfer to the hoet 




OUT 


Token 


Starts a data transfer to the device 




DATAO 


Data 




Transfers to 8 data bytes 




0ATA1 


Data 


As betore {toggle DaiaO 1 j 




ACK 


Handshake 


Information was accepted 




NAK 


Handshake 


Busy — send againlater 




STALL 


Handshake 


Inlormaion was incorrect 





In addition lo the packets shown in Table 4-1. the bus traffic consists ot 
furtherquasi-static bus conditions (reset, suspend, resume) and the 
** Keep- alive- EOP* (refer lo Universal Serial Bus Specification 
Revision 1. 1 standard for more detailed information). 

Ll'.tlra HJ. USBtJ Franre^GQO 
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A USB transactbn is a series of packets to transmit information between 
ahost and a device. Atransaction is always initiated by sending atoken 
pasket (SETUP. IN, or OUT). This pasket is always sent by the host 
because devices cannot initiate a USB transaction. The token packet 
contains the address and the desired endpoint of the device. 

SETUP and OUT packets are supplemented by a DATA packet from the 
host which contains up to eight bytes of data The packets DATAO and 
DATA1 are always sent in an alternating sequence. This procedure is 
called data toggle and serves tor error protection. Following the data 
packet, the device answers with a handshake packet. If the device could 
receive the data, it sends an ACK packet. If the device was not 
immediately ready, it sends a NAK packet signalling to the host that the 
packet should be sent again at a later time. In the event of an error, the 
device sends a STALL packet. 



SETUP Transaction 

Host 



Host 



Device 



SETUP (ADDR.EP) DATAO (D1..D8) ACK 



OUT Transaction 

Host 



Host 



Device 



OUT (ADDR.EP) DATAO (D1..D8) ACK 



Regarding IN transactions, the data packet is sent by the device and the 
host closes the transaction with a handshake packet. 



IN Transaction 

Host 



Device 



Host 



IN (ADDR.EP) 


DATAO (D1 .08) 


ACK 
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If the device does not hold any data ready for sending, it sends a busy 
handshake NAK instead of the data packets 

IN Transaction (Device Busy) 
Host Device 



IN {ADDR.EPl 



NAK 



While the actual data communication via the stream pipes is based on 
simple IN and OUT transactions, the management of the device uses 
more complex control transfers via the control endpoint 0. These control 
transfers are secured using a double handshake. Control transfers 
consist of two or three transaction stages, like those shown here. 

2-Stage Control Transfer (No Data) 

Setup Stage Status Stage 



SETUPDATAO.ACK 



II1DATA1.ACK 



3-Stage Control Transfer (Host Read) 
Setup Stage Data Stage 



Status Stage 



SETUP.DATAO.ACK 


IN.DATA1.ACKU) 


OUT.DATA1.ACK 



The setup stage starts with a SETUP transaction (see above}. The data 
stage is necessary if data has to be sent from the device to the host and 
consists of several IN transactbns. The status stage serves for the back 
confirmation that the information was processed correctly. In the status 
stage, empty DATAI packets are sent. 
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4.9 USB Implementation In the Reference Design 



The following paragraphs describe the implementation ot the USB into 
the reference design. 



45,1 Activation otthe USB Module 



For initialization of theMC6BHC908JB8 USB module, the user program 
must call the initialization routine initUSBQ, This routine writes all 
registers with the same default values. which are present after a 
power-on reset. Beyond that, the USB module is activated by setting the 
bit USBEN In the USB address register UADDR, 



Bii7 



BitO 



USBEN 


UADK 


UADDÔ 


UADD4 


UADD3 UADD2 

! 


UADD1 


UADDO 



F^- 
Write: 

Recev 00000000 
Figure 4-1. USB Address Register (UADDR) 

In addition, the bit PULLEN in USB control register UCR3 is set resulting 
in lhe internal puilup resistor at D-/PTE4 being activated if this option 
was selected in the source code. For this, the macro USBJPUE must be 
defined as I. Alternatively, it is possible to add an external resistoron the 
USB08 evaluation board (see Section 2. Hardware Description), 



455 Endpoint Configuration 



The integrated USB module of the MCHC908JB8 supports three 
endpoints. In addition to the mandatory bidirectional control endpoint 
EPD. two unidirectional Interrupt endpoints. EP1 artí EP2, are available. 

The data direction is always indicated from the view of the host An 
IN endpoint serves for the data transfer Irom the device to the host and 
an OUTend point is used for the dala transfer from the host to the device. 

EP1 Is always configured as an IN endpoint. since the MCU sends dala 
via this endpoint. The endpoint EP2ol the MC68HC908JB8can be 
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configured as an IN or as an OUT endpoint The reference design uses 
this endpoini 35 an OUT endpoini, to do data transfers to the MCU. 

Table 4-2 provictes an overview of the endpoini configuration. 



Table 4-2. MC68HC900JBO Endpoint Configuration 



Endpolnt 


Type 


Direction 


Function 




EPD 


Conkd 


IN/OUT 


Device configuration 




EP1 


Inte rnjpt 


IN 


Data lianslcr lo lhe nasi 




EP2 


Interrupt OUT* 3 * 


Data transfer lo lhe device 





a. Alternou ve4y as ií cúT\fiaurafci!r- **t: ontan *= nn> lj3c«í here. 

Some adjustments in the control registers ol the USB module are 
necessary for the configuration of lhe endpoints. While EPO is always 
active as a control endpoint, lhe bit ENABLE1 in control register 3 
(UCR3) has to be set to activate the endpoini EP1. LiKewise, the bit 
ENABLE2has to be sel for activation of the endpoini EP2. 





8 ft 7 


B 


5 


A 


3 


2 


1 


Bi!0 


R*3d: 


TX1ST 


D 


-OSTALLO 


6TAUÍI 





1 Pill 1 Ptl 


EVUSLE2 


EK43LE1 


Write" I 


TX1STR 





i=t=aet 



D 

= Unirpfemenfed 



Figure 4-2. USB Control Register 3 (UCR3) 

However, the aciivalbn of the endpomts EP1 and EP2 takes place not 
in the inrUali ration routine inrtUSBf). but only after the device receives a 
USB reseL 
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45-3 USB Reset 



An USB reset is an event which is used by the USB hub to reset the 
attached devices lo the initial stale* Electrically, the reset signal Is a 
special bus condition (single ended zero) which is initialed by the host 
and then passed on by the hub(s). 

The USB module of the MC68HC9D8JB8 reacts to this either with a 
hardware reset or with an interrupt, dependent on the configuration 
selected in the CONFIG (configuration) register. Since a hardware reset 
(inparticularduhng the debugging via monrtor mode) is not without side 
effects, the generation of an interrupt is preferred here. For this purpose, 
the URSTD bit in the CONFIG register has to be set. It has to be 
considered that a write access to lhe CONFIG register is possible only 
once after each power-on reset Therefore, write access to this control 
register is done in the function _HC08Setup{) in the module 
U08MAIN.C 

The USB reset Interrupt, together with all the other USB sources of 
interrupt, points to acentral USB interrupt vector The USB interrupt has, 
apart from the software interrupt (SWI), the highest priority in the 
interrupt system of the MC68HC90SJB8, The USB interrupt vector is 
stored at the vector address OxFFFA/OxFFFB (see 3*6 Interrupt and 
Reset Vector Module VECJB8.C) In the reference design, it points to 
the function isrUSBfl. which is responsible for the entire 
inierrupt-controlled USB handling 

In the interrupt service routine all applicable interrupt flags are 
successively examined. If it is recognized that the RSTF bit in the USB 
interrupt register 1 (UIR1) is set, it means that a USB reset interrupt has 
occurred. 

In this case, first the function initUSB() is called to set all control registers 
olthe USB module into the default condition. Afterward, lhe two interrupt 
endpoints, EPi and EP2, will be enabled to prepare for the following 
transfer of data. Now, the local interrupt enable bits TXD0IE r RXDOIE, 
TXD1IE andRXDIlEin the USB interrupt register (UIRO) are set so 
they can react on the information sent or received from the endpoints 
using interrupts. In addition, theend-of-packet interrupt will be enabled 
with EOPIE (suspend handling), 
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Bit 7 


6 


5 


4 


3 


2 


1 


BitO 


Read: 


EOPIE 


SUSPND 


TX02IE 


RXD21E 


TXD1IE 





TXDOIE 


RXDOIE 


Write: 


- 



r 





1 = Unnp lamented 
Figure 4-3. USB Interrupt Register O (UIRO) 



At the end of the USB reset interrupt, the control endpoint will be 
enabled tor receiving, thus the configuraton instructions which follow 
after the reset (device requests) are received by the USB receiver. This 
option will be enabled by setting the RX0E bit in the USB control register 
(UCR0). 



Bit? 



EiLU 



'/nil*: 



rtese:: 



TOSEQ 


o 

TX0E 


RX0E 


TP0SIZ3 


TP0SIZ2 


T P0SE1 


TPOSE0 





= Lhrrpbmented 

Figure 4-4. USB Control Register (UCR0) 



The USB device is now in the DEFAULT state. That means the device is 
attached to the bus and is supplied with current. In addition, it has 
received a USB reset and reacts to instructions with the default address 
zero. For further information, refer to Universal Serial Bus Specification 
Revision f m f, Chapter 9. t — USB Device States, 

After these fundamental initialization steps, further setup steps 
summarized under the term of enumeration follow. 
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4.6 Device Management with Endpolnt 



4.6,1 Enumeration 



After the basic initialization described in the previous paragraphs, the 
USB module is now able to react with an interrupt on packets which are 
addressed to the control endpoint EPO. Now. the process of the 
enumeration (that is. the configuration and integration into the system) 
at the USB is continued. 



4.6.2 Assignment of the Device Address 



In the following step, the host assigns a unique USB address to the 
device, which is located in the range from 1 to 127. For this purpose, the 
host sends a SET_ADDRESS standarddevice request. Standard device 
requests are ahvays served by the EP0 + These transfers are control 
transfers which are implemented for the EPOonly (the other endpoints 
are used exclusively tor the data communication by means of interrupt 
transfers). 

USB device requests are started, by the host sending a SETUP packet 
The MCU receives this information and generates an EPO receive 
interrupt. In the interrupt service routine isrUSB(), the interrupt is 
identified by the controller on the basis of the RXDOFtlag in the USB 
interrupt register 1 (UIRI). 



1(17 



EitO 



EOPF 


RSTF 


TXD2F 


BX02F 


TXD1F 


RESUMF 


TXDOF 


RXDOf 
















^^^^^Hl 




















a 






Wife 
Reset 

= Uitnptemented 
Figure 4-5. USB Interrupt Register 1 (UIR1) 

Since a receive interrupt could be initiated by an OUT packet for the 
endpoint EPO, it must be determined whether the received information 
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refers to a SETUP or an OUT packet. Therefore, the flog SETUP in the 
USB status register (USRO) has to be examined If this flag is set, the 
last token received by EPO was a SETUP token and the interrupt routine 
Is branched to the function for handling ol SETUP transactions. 
handleSETUP(). 
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ROSEO 
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RP0SE3 


RPCGE2 


RP0SE1 RPOSCO 1 


Write: 1 

















ftaet U^%ctedl7r «sel 

= Onirp lamented 

Figure 4-$. USB Status Register (USRO) 



In the USB staius register (USRO) the functOn handteSETUP() finds 
not only the type of the transaction (SETUP or OUT), but can also 
determine the number of received bytes. In the case of a SETUP 
transaction, the data length is always defined as eight bytes. Therefore, 
USPO should contain the value 0x48. 

The eight bytes received by endpoint are available in the eight 
registers UE0D0-UE0D7 and will be transferred into the buffer vanable 
SetupBuffer This variable ot the type setup_bufter is explained in the 
following excerpt trom U08USB.H 






St :f.:iri fç^Ç^ " : |« 
* v* \ uc Pi do 



an. 



ii'M* "f : 



The frekj bmRequestType must contain the value in bits 5 and 6; 
otherwise, it is not a standard device request 
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The type ol standard request is coded in the field bRequest. For 
continuatbn ot the enumeration, the host should send the standard 
device request SET_ADDRESS and the handleSETUPf) routine should 
branch to the function setAddress(). 

The function first validates the contents of the fields of SetupBuffer In 
the case of an error a STALL handshake is initiated to give the host 
problem feedback. 

Before the device address in the field wValue is finally accepted, the 
MCU has to prepare the transmission of a receive acknowledgment 
This acknowledgement still is completed using the old device address 
zero. An additional safety feature is the mandatory control transfer status 
stage. 

The handshake takes place via a telegram with a data length of zero, 
which is requested by the host by means of an IN transaction. For this 
purpose, the length TPOSIZx is defined as zero and the TXOE bit is set 
in the USB control register (UCRO). This enables the transmitter of the 
endpoint 0. 
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T0SEO 





TxOE 


RrtE 
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TP0SIZ1 


TPOSE0 
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1= Unimplemenled 
Figure 4-7. USB Control Register (UCRO) 



This handshake transition always uses a DATA1 packet; therefore. 
TOSEQ is set 

The routine setAddressf) now returns to handleSETUP() where the 
receive interrupt for EPO is re-enabled. Finally, the MCU terminates the 
interrupt service routine isrUSBf). 

The device address is still located in the SetupBufter. The service 
routine isrUSB() is again activated by a transmit interrupt for EPO. After 
decoding, if rt was determined that the cause of the interrupt was an IN 
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transaction, the function handlelNQ is called. In the field bRequestot the 
SetupBulfer. SET_ADDRESS is still contained as the current standard 
request type. The tuncton handlelN(J now reacts by transferring the 
device address from the buffer to the USB address register (UADDR). 



EitO 



Read: 
Write: 



US GEM 


UADDG 


UADD5 


UADD4 


UA0D3 


UADD2 


UADD1 


UADDO 



r 





= Unrrp fomented 
Figure 4-8. USB Address Register (UADDR) 



The device is now turned into an ADDRESSED status. An exception 
would be if the transmitted device address was zero again. This case 
would mean an uncoupling of the devce from the USB system. 

With the completion of the IN transaction as a status stage, the control 
transfer for the treatment of the standard device request 
SET_ADDRESS is finished. The completion is noted in the SetupBuffer 
by setting the flag REQUEST_COMPLETE. 



4.6.3 Requesting Descriptors 



Further in the process of enumeration, the host will request the 
configuratcn of the devce. For this purpose, descriptors which contain 
information about the status and one or more possible configurations, 
are made available by the device . The host loads these descriptors, 
selects a suitable driver and forces the device to take a certain 
configuration. As a consequence, the device will be ready for use and 
will be able to transfer data via the interrupt endpoints EPI and EP2. 

Sending descriptor information takes place during a standard device 
request The request is of the type GET_DESCRIPTOR and in principle 
is handled the same way as that for the standard device request. 
SET ADDRESS, described above. 
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Within lhe setup stage, the functon handleSETUP(} is called. The 
request type is recognized as GET_DESCRIPTOR and branched to the 
subfunctbngetDescriptorQ, There, it is determined if a device 
configuration or string descriptor was requested. According to this 
requirement a pointer will be set on the respective data source. After 
examination of the data length, this data will be written into the USB 
endpoinl send registers UE0D0-UE0DZ 

The numberof bytes is limited (at least for low-speed USB devices) to 
eight bytes per DATA packet, II more data has to be transferred, the 
device has to divide the data into blocks of eight bytes and distribute 
these portions using several sequential IN transactions- The last data 
block is identified by the host due to a length smaller than eight bytes, 
That means, if the length of the transmitted daia amounts to an integral 
multiple of eight, there has to be an additional empty IN transaction (data 
length zero). 

The data length and the transmitter release bit TXOE are inserted into the 
USB control register (UCRO) (see SET_ADDRESS). then lhe data is 
available for the host to pick up. 

inhere is only one packet (length smaller eight), the 
GET_DESCRIPTOR standard devee request is marked as complete 
(REQUEST_COMPLETE). 

If several packets have to be sent the send buffer is filled up again by 
the routine handielNQ dunng the following EPO transmit interrupt, until 
all data is sent. 

Sequential IN transactions are served with interchanging data packets. 
The interchanging between DATAO and DATA1 packets is called adala 
toggle and serves for error protection. 

Detailed information about the descriptors used in the reference design 
are contained in Appendix B. USBOO Descriptors. 
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4.6.4 Device Configuration 



After the host processes all descriptors claimed by the device, it will set 
up the device with a SET_CONFlGURATlON standard device request, 
A devce can have several configurations (for example, with different 
power optbns. resolutions, or speed optbns). The configuration 
characteristics supported by the device are coded in the device 
descriptors. 

The reference design is limited to the simplest case with only one 
possible configuration. The SET_CONFlGURATION request is passed 
on by the routine isrUSBQ to handleSETUPQ. after which branches to 
setConfiguration() take place. The configuration specified by the host is 
coded in the field wValue.lo of the structure SetupBuffer If this field is 
larger than zero, the USB08 is ready to be put into operation. For this 
purpose, thetransmrtterofendpoint 1 and the receiverofendpoint2will 
be enabled and the internal status of the device changed to 
CONFIGURED. 

In reverse, the host is able to return the device to the status 
ADDRESSED by transmission of a SET_CONFIGU RATION instruction 
with the value 0. 

For the status stageofthis control transfer, the routine ends by preparing 
to send an empty DATAI packet. This is completed by the following IN 
transaction. 



4.6,5 STALL Condition 



If the device discovers an error during communication via the USB which 
requires the involvement of the host, the devce sends a STALL packet 
in place of the usual handshake packets ACK (ready/OK) or NAK (not 
ready). 



Designer Reference Manual US 80S Evaluation Board 

74 Universal Serial Bua (USB) Nerlace MOTOROLA 



Universal Serial Bus (USB) Interlace 
Communication via Endpcinte EP1 and EP2 



To force the devce not to send further STALL packets after the recovery 
of the error, the host can use the standard device request 
CLEAR_FEATURE. The responsible standard request handler 
clearFeature(): 

* Hands over the code for the endpoint concerned (0x81 for EP1, 
0x02 for EP2) to wlndex 

* Writes ENDPOINTJHALT into wValue 

* Forces the deletion of the STALL condition for the endpoint 1 or 2 

A STALL condition of the EPO resulting from an incorrect SETUP 
request is reset automatically by the next arriving SETUP token. 



4.7 Data Communication via Endpolnts EP1 and EP2 



The transmission of user data from or to the USB device takes plase via 
the endpoints 1 and 2. EP1 is an endpoint of the type IN and serves for 
sending ol information to the host, EP2 possesses the direction OUT 
and is used by the device to receive data from the host. 

All data traffic of the pay load endpoints EP1 and EP2, as well as the 
administrative traffc of the endpoint EPO. leads to interrupt handling via 
the interrupt service routine isrUSB(). The USB interrupt register 1 
(UIR1) contains information about the exact source of the USB interrupt. 
If the flagTXDlF is set, a transmit complete interrupt was indicated by 
endpoint 1 . If RXD2F is set. an endpoint 2 receive interrupt is pending. 
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Figure 4-9, USB Interrupt Register 1 (UIR1) 
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4.7.1 Receiving Data 



If data for endpoint 2 arrives, the interrupt handler calls handleOUT2() + 
The number ot received bytes is noted in bits RPSIZ3-RPSIZ0 with the 
allowed values in the range of 0-8 + 



Bit" 



ELtO 




ou u 

= Unlmplemented U = Umtfecfed 

Figure 4-10. US8 Status Register 1 (USR1) 



NOTE: 



The received data bytes are transferred from the USB endpoint data 
registers UE2D0HJE2D7to the buffer RxBuffer. This is a software ring 
buffer which can be filled by the interrupt sen/ice routine isrUSB() and 
be read out by means of getUSB(). 

If the ring buffer is full handleOUT2() waits until RxBuffer is able to store 
data again. In this case, the USB module answers further transmission 
attempts of the host with a NAK handshake. 

In a real application, you should not leave the buffer unserviced over a 
longer period of time. 



4.7*2 Transmission ot Data 



The transmit data for EP1 is placed by the user program, via the function 
piltUSBQ. into the send buffer TxBuffer. This is (just like RxBuffer) a ring 
buffer wh:ch blocks the application as soon as the buffer is about to 
overt tow. 

The host polls all interrupt end points cyclically, taking into account a 
guaranteed maximum latency time. That polling interval can be specified 
in the endpoint descriptor For low-speed USB devices with interrupt 
endpoints the shortest specified polling interval is 1 ms. That means. 
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irIOms the host asks whether further data has to be fetched from 
endpoint I or not, 

NOTE: In practice, the host uses only intervals of^ ms, the demanded 10 ms 
Is then rounded to 8 ms. 

The USB interrupt routine is called cyclically and branches to the handler 
handlelNI. From there, data is taken from the ring buffer TxBufler (if 
available) and transferred into the USB endpoint 1 data registers 
UE1D0-UE1D7. Subsequently, the number of bytes which should be 
sent is registered in the fields TP1SIZ3-TP1SIZ0. If no data is in the 
buffer this number is registered as 0. The TISEObrt is inverted to switch 
between DATAO and DATA1 packets (data toggle). Finally, by setting 
the brtTXIE in the USB control register 1 (UCFM). the transmission of 
the data is enabled. 
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Figure 4-11. USB Control Register 1 (UCR1) 

The operation mode selected here is based on a continuous data 
stream. U there is no transmit data in the buffer the device will send data 
packets with zero byte contents. If this condition continues for a tonger 
time, sending of empty data packets means a waste of bus bandwidth. 
If this turns out as critical, a change of the operation mode is 
recommended. Alternatively, it is possible to disable TX1E. as long as 
no data is present in the buffer Then, the endpoint answers a polling 
only with a NAK packet and does not occupy any additional bandwidth 
by sending an empty data packet. 
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4.8 Host Interaction: Vendor ID and Product ID 



Two identifiers are used to mark a USB device and make it possible lor 
the host to assign a suitable driver: The vendor ID and the product ID. 
Both IDs are registered in the device descriptorot the USB equipment, 

f . The vendor ID (VID) marks the manufacturer Normally, venctor 
IDs are assigned by the USB Imptementers Forum. The requestor 
is charged for this registration. 

2. The product ID is (just like the VID) a 16-bit number The PI D 
marks a certain product. The alfocation is done by the 
manufacturerof the device. Unlike the VID. for the PID there are 
no administrative restrictions from the USB Implemented Forum. 

The USB08 reference design uses the registered venctor ID of the 
manufacturer MCT Etektronikladen. which is 0x0C70. The product ID for 
the demo application is 0x0000. 

To avoid collisions and complications, every type of device is requested 
to have a unique vendor ID and'or product ID. Devices which have 
fantasy IDs cannot be used as that woukJtead to the immediate collapse 
of the compatibility of different devices at the USB. 

Registered users of the USB08 evaluation board can receive their own 
PID out of the PID pool of the VID 0x0070. which is exclusively allocated 
to the user. With these unique VID/PID combinations, the user can 
develop and sell USB equipment without having to request his own 
vendor ID beforehand. 

Contact MCT Etektronikladen for additional information on obtaining a 
unique USB08 PID. Reler to hnp;//www.ta08web.de/usb08 



4-9 Windows Device Driver 

Both VID and PID represent the search criteria for the suitable Windows 
device driver. The link between the driver and VID/PID is ctone by a \inf 
file. To deliver to the operating system the suitable driver for the USB 
equipment, the manufacturerof the USB device has to provide only a 
data medium, on which (preferably in the root directory) the suitable \inf 
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file and the driver file are specified. The Windows Hardware Assistant 
copies these two files into the appropriate Windows directory and 
updates the driver data base as necessary. Then, during the following 
"Plug Event," the Windows operating system finds lhe driver 
immediately in this data base. 

With the help of Mcrosott SDK rt would be possible for a USB device 
manufacturer to develop the necessary kernel mode drivers for 
themselves. However, this kind of programming task requires a deep 
knowledge of the structure and working principles of the Windows driver 
modules. For those engineers, whooccascnallydo some programming 
work on a PC, it is urgently recommended not to try such a task. 

A possible workaround could be the operation of the USB device using 
a Windows standard driver for human interlace devices (HID). The 
device class HID summarizes PC input devices, for example, a keyboard 
attached to the PC It is possible to camouflage the measuring data as 
an HID input packet and tunnel through the HID driver. The advantage 
of this approach is that a kernel mocte driver doesn't have to be 
developed. Instead you can program your own PC application on top ol 
the existing operating system driver. 

However, there are two major disadvantages ol the HID method. They 
are: 

1. First, the complexity of the USB handling increases, particularly on 
the firmware side. There are additional procedures, protocols, and 
descriptors to implement. Definitions of these additions are not a 
part of the original USB specification, but are in an HID 
specification, which can be loaded from the USB Web site: 

http://www.usb.org 

2. Secondly and by far more devastating, is the circumstance that 
half a dozen implementation variants exist. With each version ol 
Windows and each new service packor release, the user risks that 
some details of the USB drivers have changed. In this case, the 
expenses for testing may be quite high. 
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The USB08 reference cteSKjn uses alhlrd possibility, the universal USB 
device driver (USBIO) from the company Thesycon. This third-party 
USB driver is professionally maintained and updated as soon as new 
operating system conditions occur. The USBIO driver is used lor the 
USB 08 reference design as a free-ol-charge adapted "Light EL' version. 

For detailed documentation, components, and demo programs refer to: 

• Appendix E. Universal USB Device Driver (USBIO) 
■ World Wide Web at http:/' www. the sycon.de 



Designer Reference Manual 



U5B0E Evaluation Board 



SQ 



Universal Serial Bus (USB) Interlace 



MOTOROLA 



Designer Reference Manual — USB08 Evaluation Board 



Appendix A. Supported Standard Device Requests 



Definition of the supported standard device requests are given here. 



Standard Device Request 


ID 


Supported Options 


SET.ADDRESS 


5 


Any 


GETVDESCRIPTOR 


6 


DEVICE 

CONFIGURATION 

STRING 


SET ^CONFIGURATION 


9 


on 


CLEAR.FEATURE 


1 


ENDPOINT_HALT 
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B.3 Device Descriptor 



ccrLfct. devl:^ 



rcfipt ot Pev I c— Dp j 



IE? 'if rhu onctiptii in o^ti 



««or 


|device 


Dr.DKVECK, 


Uxlô, 


OxOlU 


o. 




o, 




* 




o. 




IdX->D J 


OxOej. 


-. . . 


OxOO) r 


■ * 


OxCl), 


t, 




J. 




■• 




t 




1? // 


end or 



tt4i r 

CI OUST 

SubcJ 
ret o 



^ rn 

t = e !)iir.fc 

■s Cede (nenc) 
o I Cede | no nef 



i ti BCL * l.lú 



' ' in 

lEElptK} p 

// tlUfXli 

' ' U50 £pi 

* .' Device 

/ / Devlre 

// Device 

// HAXlnuA roctet Sixe tar CTO 

// Vender XD * MCT Eletl tonlfcl aden 

1 rroduet ID ■ 3encile Dene 

// Device Release ilunber In DCD 

»/ Index ■ x £r itno De^c roi Hinuf jetucer 

// Index if It iing De*c roc Pccduct 

/' Index if Sttino Deir roc SerKc 

/ / ííuns et of pc^ai ti e ir-ir. t t qur o t i on* 
Uevi eebefle 



B.4 Configuration Descriptor 



i-cr.n i-in! iguia- ; a n^deict tptvt rant I QQete ^ 

I • ■' ílir c[ thla Deteilplor in Brtev 

jfi ieor (cQ^r: gui 4 *. t q n^deacri pto 1 | , 
Dr_CO»tris1DnJLTl OH, f f Dwcnptot Type (*2> 

1 ol reot (cenrl «urttl on.deffript or) * nieor 1 1 nt e?* ; iee_denfflpt or) 
sir e-i r ^endp si m^dett uptor) * si xeof cupiiri _ u*ri cupt et í , 
Qxaof, // Total Lenoi n ?i Data for that Cant 

L, He - * Interfere* supported iy this Cant 

L| // DeilQniLat Value t»i *thls» Cenf iqurat i en 

O, '7 index *r rtiing Dear roe tMt Cant 

OkcC., f / 'el t 'poneteilf no peiidi e ■Wav etie 

O Hak. rawer CenmvpLlon in this Cent (*£rtM 

i; ■ ' end of "ontta&eac 



Designer Reference Manual 



USB08 Evaluation Board 



USB08 Descriptors 



MOTOROLA 



US BOS Descriptors 
Interlace Descriptor 



6.5 Interface Descriptor 



ten pit inteirir^^^^t^Eipio: 1 m Fiiíc^rçtc ™ 

| /' Slip at t r-t ar QcvciI^tM tn iytes 

ai xcflf {intcrf ■ c e_des <■ r i p t c e y , 

dt_i HrswActr, /./ jns?ujnu rvpc l™4> 

O, *f Huft&ei or ^(llí' JntCfídCC (O.. I 

O, ' Au-m4tlvr toi - nl * Intcttacc U' *»»V.* 

3, // Mt »r iri used t>y 1 ni 3 :: (Ctrl. RPDl 

Oxff, ir :Wj« Code C'xu * Vender iprclrir^ 

OkDL, fí IntDiEArc Subcldjja Cade 

oxtt, r ,* Xt riflticel Cade <Pxri - Vendor «pecirtc» 

a ' Index if ttriha 3ur cor thli interface 

| ; / / end o it Irtt Fire r?Dctc 



B.6 Endpolnt 1 Descriptor 



runiL en dp 01 n( fc icac rt pt or En dp at t\% IDcjc " 

1 fj SJxc or tbli neseut't:» in Uyn 

si inn í Jendpoi nt _ic*rr ipLoi| , 

»r_E:unPOI jiv, '' Oexcilpeai Type f"^> 

axst, ' Kntipetni Addreitjc inn. FBI 

OkO), I ' IntFirjpt 

|€xae, OxDC) P ÍÍ t(dx. Cntlpcint Packet Slia 

la ' r ( K i nj Interval |int?trupt) 11 

I; // end of Cndpalntlbcic 



B.7 Endpolnt 2 Descriptor 



const, en dp mnt^ílFtf^itpl or Cttdp o j nfc — t'j fa ■ "■ 

| / /' SJic oe thli Lcveilptor in Oyi-i 

t* i xcor {en up j 1 ni_iurnp( ct| r 

Or_CKtJror WV, // Dncilptor Type (*^> 

CxDZ, // Endceint Adúrc» IttrJ. OUTI 

OxD3, // Inleirupt 

( OxOO, OxOO), // Max. Bndpelnt ra.'iet flic 

1G // PDlllnq Interval llrttrrnrpt) in 

(s // end or CndpeintXDctc 
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B.8 String Descriptors 



LdngUaGE I ITe 






t/ 5me, Type 

ft LinjIH Cad» 



I ^L' L'tCH; 



rv 

.'/■ 

fdi 



i n ki l d^. met j^ i i rv" 



! i e;i Ctil LRU tfiíç^f ('iter Rlp^itmlH a d en" | * 2 



»t uchar £lrt poIDcpc I 5~ 1 Lett: * 
■' Use, Type 
SOI LEÍI. 0r.5tMH3, 
t'l Utn*^4c Strinq 



a, 
o, 
a, 
a, 
a, 
a, 
o, 

Q, 

a, 
o, 
a, 
a, 
a, 
a, 
^i 
o, 
o, 
t 
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US BOS Descriplcrs 
Siring Descriplcrs 



.'/ frcduct St imo 

*J;ii™.e S02LCH ali»£ ('UEa&O Evaluation &D«rd*)>2 


»nrt ■;■?♦;: St r : nji&HC I IBS LRU J * i 

f iixc, Type 

sancH, DT_srt\i «a, 

it Unicode Stfinj 



a, 
a, 

a, 
a, 

t 
o. 

Q, 
a, 

♦ 

a, 

a, 

Q, 

a, 
o, 
a, 

, 

a 



I? 



.'/ rfl&U of String Dcf^rlptoii 



*tn naSDettc, 
-í' r l nql Detrc, 
St rtngSD^vc 

I; 



rribi cj i 
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Source Code Files 



HC908JB8.H 



define ^MCCo_Ml 

' Tent col Rcgl iter Dcrtnitl onm rsr rtC^OOJDO "■ — ■ - ■ : » ~~--^.~^^~. — 



;flne _r (or f i 
:fine _LP lol í t 



delln? 


rra 


del in- 


rre 


del In? 


rrc 


del in? 


rTO 


del lnc 


HDItA 


del In? 


odk& 


del inc 


D OK? 


4 - ! I n e 


DOKC 


4~f 1 ne 


rre 


del in? 


dom: 


del Ine 


TBC 


/net In pi 


enent cd 


dellne 


rcwrM 


del Inc 


TCU7L 


del In? 


f«o: n 


del inc 


:)i:l: 


4-! i nc 


t : " 


del in? 


r cno ii 


del in? 


rcnoL 


del In? 


reel 


d-f 1 n? 


rem ii 


delln? 


TCMLL 


del In? 


Kpscn 


del in? 


r si : ~r 


del in? 


til 1*2 


del In? 


UCR3 


del i nc 


Ufh) 


del in? 


UCIM 


del In? 


i ocn 


delln? 


rcci* 


del in? 


z sett 


4ef t n? 


■." :?:r i * 


del In? 


ukoso 


del in? 


'JCL'Si 


del t n? 


UK032 


del in? 


Ml ■■ 


delln? 


UKOD4 


del t n? 


UKDD3 


del In? 


UKOOC 


del in? 


UB0D7 


del tn? 


UEl DO 


del in? 


UEID1 


delln? 


U£A2S 



i > :■: ■ 



* (unuancd rhor volatile ■) l_t f 

* (unit qned unerf voltLllc *| |_EO_BASC: 



.1- {Ox01| 






..■>■;■ 
,r ! Dm Oil 

.r 1 ox 04 1 

.r |OhO"i 

.P f OxOCt 

.r toxo?| 
.r jdxooi 

.P 10x091 

,r IDxOCt 
.P tOxDD| 
.1* 1 0x OK I 

.r i ox or i 
_r 1 ox i a i 
.r | ox i if 

,r lOxiJj 

.r (ox i if 

„M DX 1 < I 

_F i Dm I 3 : 

_r !nxi ?| 

.PlIÍXiM 

_r | ox i í f 
j* | Oh i a j 

> , : . 

.r 4 ox i c J 

. r i ux i o i 

.P 1 Ok 1 IT | 

/ I ox i r : 

.r |0x20( 

,r {Oh 31 I 

.P1Dh33| 

r rax;ii 

.r ID* 24 I 
_r 10x231 
„r lOx26| 
.FIO» 271 

_f ! cxra I 
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J-! I n- 


UEl El ? 


ijef In- 


UE1D4 


del ine 


r, T . ' 


define 


UElBC 


i»p| Ini 


UEICI? 


del inc 


1 ■! , 


.J-f 1 n^ 


UE3D1 


del inc 


UE2t)3 


del inc 


r, T , 


del ine 


UE3D4 


define 


UC££35 


aef t n- 


UE3DC 


3-! t n- 


UE3DT 


define 


vai r 


del lne 


UJHO 


del lne 


TJ I Ri 


4-! i nc 


' T ' Í» " 


def lne 


urni 


del lne 


tJSRO 


del lne 


U5RL 


/not l*pl 


eti^m e; 



lox^r? 

/ u-hn ncaineit: 

def lne TCIir 

det lne r»i . : 

define TCtlO 

define TCHL 

{— — att Ntirfe t'siir.t'.i.T.! 



_r 1 0x2&1 

_r ioh2C| 
_f iox?ui 
_r |ox2Ei 

_r* !Ox£F1 

_r 1 0x : o i 
-Mo* ill 

_F (írxíli 

_r t ox " * 1 
_f { ox i o í 
_r | Ox : c t 

_r I x : 7 I 

_r < ox í e i 
_r|oxJ9| 

_t- | ux 'a; 

_r ioxsdi 
_r ioxsci 

_P luxJDl 

_r tox íeí 



lOXOCJ 

_tr f ox or | 

_LP lOxllj 
iCx 1 4 i 



f Bite in UADDft: 
del lne BN_U£clS» 



ox aa 



nit x 


in uino: 




cf lne 


DM_EQFIK: 


Ox 00 


el lne 


mi _ rot E - : E 


OxiO 


- ! i ti - 


DN^VXDl I E 


.- ■ 1 


ef lne 


OK_DCD0r E 


0x02, 


cf lne 


DN_RXD01 F 


Ox O I 


Die* 


in lit Ri : 




ef lne 


B«_Korr 


■ >: 


cf lne 


bn_rs tf 


0x4 


ef lne 


CH_RXD3r 


oxio 


cf lne 


dn_txdif 


.x ■ 1 


ef lne 


BN_rxDor 


0x02, 


ef lne 


DN_RXDor 


Ox O I 



f Dlt* in UIR2: 

define BK_aOPf!t OxaO 

Mdefmc »H_R3rFH 0x40 

def lne Bti_RXD?rR Ox 10 

irou? dn^vxdifr ox on 

define DH^TXDOrR 0x02 

define DN_RX DOF R Ox O I 

f Dlti in UCRC : 



. ■'/ ME» Module Sihmi 



/ / Knd-et*r irkrt Det ert I nt e erupt EnacK 

// nr: Rx ír.iíEinfi CnabLe 

/ / EFl rx Interrupt Enable 

// :'i".- Tx Interrupt Enable 

// KFO Rx Interrupt Enable 



/ / End» of -Packet Detert rn: 

// Clear r*cset Indicator Hit 

// KF2 Data Receive riag 

// EH Data Trtnatiit ioiipl^-R tUi 

// nr r Data Trimnlt cenpletc tto>: 

// EFO Data Receive rug 



// ttnd-er-Fackel Fl * o Re.net 

// Clear React Indicator bit 

// EF2 Receive Meg nciet 

// EFl rrinanlt cenplete Mig Revet 

ft RFC Trimnlt rcnplcte Flig Revet 

// EFO fleeeive Flag React 
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•i*Mr-.- BN_TQ£t£C OxBO 

• del inc bH_rXDB 0x20 

fdellne DN.nXDC OxlO 

MMcflne OH^TrCSII OxOf 



// SFO rx Scqurncc ait (OATAO/ 1 | 

/ / ttrc Tx CncbLv 

// Sro Kk Cna&Lc 

// RFC rx bita rarltct 5lxe 



Hit * in UCnl : 

fdcl ine H«_ir*:ii Ox 4 

•define bN_rx;e :x;: 

^/t domina Bh_rnstr oxor 



/ / Ktl rx Eeqtjen 

// Kri Fflrcc Atd 

// Erl rx enable 

it cri rx bin r 



íc ait (datag/ 1 1 
1 i ait 

ackeL CLH 



// ait* in UCI12: 

fdPflnc »H. . S r A ll: Ox 4 O 

Vdcllne UtfrdtJH Qhla 



/ / Bra Farce Atoll 
/ 1 era roc GnabLc 



1 ; * 



// aits in UCK3i 

• del ine rjH_rXiS7tV 1x4 2 

ídcllnc bN_O3rALL0 Ox JO 

'drin» bM_2SrALL0 Ox 1 O 

•deline ní<_r- r iLrii >: ; 

íijpltnc bM^GHAbLC? ' 

f define bNBHAbLEL OxQL 



// Clef i sr*0 Transmit -l*t ridg 

// Bro fflrcc STALL ait ror our refcer 

// cro farce STALL ait roc III Tatcn 

// r„;:-i; CMblc 

// era tru tic 

// KT1 EmMc 



// i* i ■ .- in U5RO: 

ff ("define bM_H05£D OxflO 

Idctlne bH_St£ TUP Ox 4 O 

//tdeflnc DH_nP05lZ flxOf 



/ / KPo Ax fcqi 
// Setup rexcr 

// ero rue Diti 



in* e 3i ». i :.\:a , ■ . i 
Del e*t Bit 



// Blta in USUI : 

//(define DH_n2SE0 OxdO 

# def I fie ON_f t T-í s; Z Ox Of 



// era Ax Sequence bit ^ArAn/ 1 i 
// tsra Ax bita racket ffl*e 



// 

fendi C 
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U08USB.H 



Tunc; Definition ror USB Data Tyf-- -h*ti(it* 

Header Vile Cor UZBOd Deno Application 

Auth: <C ) 3 DOC by HCC RletcttinlXl^âen Obit, Oliver TAamt 
h* tp : ' 'w *w . el ek f- r on-i k 1 a d en. de/nrl 

Ren.: Vies/Edit thu Mie Kith TAD*Jii(T* 



// -- Ddtd Type DctlnLUmj 



typcdel itiuet . Eata Type "Inlei Mot^ 

uchdc le; /' (High/Low Byte Hipped! 



lw«i 



/' 



Í7 


Stindard Device Dei^ riptoi 


/' 


according to U5B1 .1 spec pa^e 








I'/rcd"! stcu;t < 




■-i"ffl E 


b Length; 




m?ti* f 


bQescrlpt erTypcj 




i*e-rd 


bcdU£B; 




uíhd e 


bB evi ceCl ass; 




uchd e 


bSevlceSubCl ísí; 




ucha e 


bQevi f cf ttt ^ ■- . i ; 




uíhd e 


Jj?í ax r i ck et Suc^; 




ix or d 


idVPhd&ri 




i * : I -J 


idrreduel ; 




Iff 9*4 


bcitDevl ce; 




uchA e 


iMonur hi urcr; 




ucha r 


if f 'jJufi ; 




ucM e 


iSerldlHunber ; 




ucha r 


briunConr 1 gur et i onv; 




I rtev l ffi_dB*rr l pt s r r 



L37 



^ne of Oia Descriptor in 3yt cí 

l*4cilptor Type (■ l » 
// USO Spec Release ftuttber in BCD 
// Device Class Cade 
/J Tevlce Sutirlf» Code 
// Device Protocol Code 
// Htxinufi racket Stie tor Rt*0 
'/ Vendor ID 
ft rroduet 3D 

rev ice Release Husber in BCD 
t f \ ndex of St r i ng D esc tor Ksnurtci vi r t 
// Index of Slrinq Dctc tor Product 

Index ol String Deve Tor SccHo 
// HiiBbcr or possible Confleuntlona 



// 



if Btanda rd Conr l g un t 1 on Deicrlpt or 
// according to U3B1.1 spec tsje «BB 

typedcr art rue t * 

ucna r bLcngth; Clxe ol this Deicrlptor in Byt i 



■■■■ 


Clxe 


el Lhu D-: 


icel 


■'■' 


L ra c r i^i □ c Vy p e 


i- J 


n 


Total Lengrh of 


Die 



ucna r iin-ntri (i orrypc; 

ixord uTox Al Length; f Total Length or Dita tor this Cent 

ucna r bttus.1 nt er taces; tin of Interfaces supported by this "t>nf 

ucha r bContlgurat i onValue; ' \ designa tor Value tor 't-his* Conn our at ion 

ucna r iConfl jurat l en; tj Index ol String Devc Cor this Cent 

ucha r bnAt tributes; // Con 1 1 gu rat t on Cha ract er l st l :i |see bel c*f \ 

ucha r bKaxfover; Hax. fewer Consumption in this Conr |*2nA» 

I con 1 1 gur at i on_dcscr iptoi; 
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/y dccsrdl 
// 

Lvpcdel st 

- I. A 

vie tu r 

uchd r 

■ , - ; ., : 

UCh4 Í 

- ;.: ■ 
■ , - ; . ■ ; 

Li." ll4 I 

uchd r 
I int 



d t nt *;íííp Dctc El pt at 

ng lo U1PI.1 spec pd^c 202 

i '-I' ' \ 
bCçJrlif l c- í 7 y r - i 

t>I nt erf a c ctli±T*t3 cr; 
bAtr irr.at cí?t t injj 
bitus&ndpQ l nt ft; 
t>I fit erf dccCl «if j 
& C fit erf ficriut"! 43?j 
t>I nt erf 4 r cP c^t Deal ; 
II ntcrtdfc; 



// Stse of thi* Descriptor 

r^ifriptor Typr i*At 
' .' Uunter of 'this* Interft 
// Alternative for thli Int. 

// 

■' • 
ti 
ft 



cC era 



I tit erro 

I tit e r r 4 
Inter f* 

1 IlJííl L 



CI « as Cj de 
Subclass Codt 
rut ocoL Codi 
31 1 1 no Lc:c t z 



in flyt cd 

« \a. .) 

erf ící u ' my) 
V lexcl. Cr3) 



i tn i 



i nt ct:i 






n i nt D?iccripl or 
L':p! .i spec t jfl J" 



// Stftidon ttr. 

/» SfiíDtBiní t 

. ■ 

typedel vt ruet < 

ii- h i? r blcnat ii ; 

uchd r bDcae rt pt orTvpcji 
uchir >>ffndp4i nt Add* c» 
in?ha r bnAt t rt but ct; 

ucht r £>I nt erv * 1 ; 

I cndpoi nt w dctc rlpt » r j 



so ' 





SIec ii ihi* Descriptor tn Byt» 


■'■' 


Imrriptci Type *~^l 


.'■' 


Endpolnt Address (Kurtbe: - direction) 


// 


Ctnlpoj nt AttrlhutCB | Transfer Type) 


n 


Max. BndpiMnt fccMet ^;zr 


i* 


Polling Interval {Interrupt! - 1 - *" 



// 



' ' Structure &f Setup racKci. sent during 

BUrur Stdge of Stmaira Device Requexti 
ff according to V5P1.1 spec pa je I s j 

tvpedel struct I 

ucft4 r & o Request fypc; 
uchdi r bfte^uest ; 

i *■ i- í 3 kV '. L uc; 

iwerd r/I ndtx ; 
iwcid w ten at rt ; 
I setup_t>uf ret; 



/ ; ctu ra et eiivu cs tUl re^t ion, Type, Recipient J 

Stindctd ttequest -Vodc 

vjI itr riel d 
// Index or Offset Pield 
fi Ilunber of Dyt» Li Lramtet (Data Stagcl 



/' 



UEO Status r: i 



Mine w_ArTACHf[J 

rf lne US_POWttWitJ 

Mine US_D£FACLT 

:flne US^ADDRKSSKD 

sfinc U5_C0»ri(3t;RBU 

ililic USSU 5f E IIS ELD 



OxDl 

OhDI 
■ > 
OxD4 



// Lnst 



id n- 
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// 



// acrocdlng to V5P1.1 at 

'define OSr_5TfirU3 

ídpítn- CL£Aft„rsArunt: 

'del inc ^^r_rnAr + jfU: 

fdtllnc £ltr_A DOMES? 

idptinc aKr_DES "it t trait 

Adeline 5Cr DESCItlFrOn CxO? uptunal 

# define OKr_CGrtr I GimATI ou 

fdEtlnc StíT^CCHfl OUttATl CH 

tdeiine acr_: urcitrAce: 

'dpiini sterol ursitrAcs 

fdrftne SYHCn_rttAME OxOc t optional 

Adeline It K O UK 5T_C D Ht"L ETC Onrc // not part af the Standard * }uit 

// a Tltiz to indtctte :j.a: thr recent 



' ' 


i r :o j 


F> 


**e I 


"■>. 


n z 


Ok 


Dl 


- 


L3 3 


Ok 


D3 


Oh 


oa 


0» 


■■ ? 


■> 


□ n 


0» 


OS 


'. 


' ■ s 


Ok 


C'Sj 


' 


■ " 



p.-(iu-ii Tiitr been Mntfhcd 



, 

// Dcflcrtpt or Typrc 

// HCfOtOinj to U5P1.1 ip« p 

tdeitne Dr_DITVI-c i 

ídríitiç i>r_CCWri BUAAriON 2 

I define Dr_srnr«o 3 

t define OT^IWraftTACir A 

fdrf tne S>r_trMDI*aittl a 

' » runct 1 an fret t». ypi? 

vui dim tU5B . > ; 

urha r octUSb <> j 

void putUSa (urhtr t| ; 

> interrupt void l «rUSb O ; 



//- 
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n 

// rune: Hc4der tilç rot nr?:i Module or U5DDO Deno ftpj 

f/ 

// 

ft 
// 



Pune: Header Tile tor nrJí: Module c í USODO Set 
Ver . : 1 . DO 

Auth: (C^OOO^DOl by OUvec rnan* 
KCT Clefct tonlK laden Obit 

http:/ /hcODwfb. de/uibQB 
nw.: ViQr/K4it imj rile; rittn TA6^Sii(T* 



í'/-- Function Protctyp* 



void inussci i| ; 

VOld pUt^Sfl (rim 

rhit get ÍSC; <> j 






U08LED.H 



//— ■ 

// rile: UQBLKD.H 

/ ' tunc: LSD function* for UCOOn 

// Auth: <Cl£DOa by KCT Klcklranlkl^ 

// h*ip://vvtf<eltílrBniRlddrn. 



OllVC 



rr-.anti 



'/net 



//« 



v 



in lmj 



lule - jujit Hi 



■define inlLLEDt) 

«dei ine loqqI =líc (x i 

* deí lne off LSD (x) 

#de* Ine on LSD |k| 



(DDnD I - OS 
IrTO -- II 

irro \ - u 



DTI 

<< |x-i|J 



irra *- u « (*-i)l> 
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U08MAIN.C 



tfunc: Nitn Module for uro&r &-ne AppUcdtion 

Ver . : 1 . OQ 

Auth: (CJ 2DOO f 2DOL by OUvee Tnann, MCT ElatronlKlAdcn Gbíl 

hup:/ /hcBBveb . d-ZuibQA 
Hitr: n-ji J d the project uiing UOOHMN.C, UOOKcrr.C, 

■ nd VRCJacT.7, u»e CftT3J&e.3 as C~5tartup Kodule 
Hen ^ : Vicw/ffdlt thu rile a l t h TAaiLic-i 



//-- Set wt T rtt Ertacrl 



'define U3E_U5&_I" ETC V/ by defining oc NOT J-f ;uir/i i 14 ; 

I Abd before -coupi t l tnj, you can 

' f deleft the c :ntiiif. a =a t i^it iht t: Hce 

;if deiincd - .» WSb* if net ■> 11=233) 

flnrludc a heODlb».h' i'| MriOBJ9Q RcQt«I?c and blinap Lcnniiunv 

flnrludr ■uDflfcey.h» /J Xeyboacd Module flea dee Pile 

'inrlude "uOeied.b 11 // LBO Module Header Pile Ouar Kdcr?i| 

'include 'uOOade.h* í'| "^r*. ACC Module Meade; flic 

// -- Co*pt lei 'dependent pt «f f ™ ■ — ■ n ... ■ < 

fijeilne ;U(l _aan (" ei i - * 

«define nap (I ,i«('nop"J 

ti-- Odtd rvpe Deilnlllonj — ■ — 

t y p edel unvl^ned ?ha r ucnai; 

'ir 4ef ustt_ucu.PirE 

hnrlude "uOBubb. :' ■ ute VSt> inpleaentdLlon 

tdDfinc imtripc LnffcBjtz 

«define getPipe gel USB 

'define put Pipe putU£n 

*ClMC 

finrlude "uOflDS.?* *' uie r-::: inplenentttion 

* define tnuPipc inltSSCI 

'define oetPl pe act 3 SCI 

'define putPtpe put" 

Pir.ierrupt veld i jr'.'soo I ' 

fendir 
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}< Tdinoy thhji dhouU tie done t eifiedi *t ely ^ft -i ?çs« 
// Ittiia is called by ih? r*Simup HoAuLcj 



void _HCOD3ctup () I 



/>' VS» React DUtMc, 

" eicir rsrer, rxat 



ror :.':?*;■: i 
i lcr*fl 



ft* 



/ *■ tlííc a Drcdltpolnl here ir» ebve you dec Icottno fee xpuElflui Interrupt ; 

N 



nop U ; 



'/ ]uit fa e tTbuq^t nr 



//■ 



Vol d fíth\j 



ii-^fnfl e n, * ; 

uch«r 1 s.buriet i»! ; 

ucti4 e 4dc( ! J ; 



inilPipcll ; 
mil LEO O r 
inltKey |i ; 
itiii SADC U ; 



' .- »nu H3235 or USD ripe 
// inlt LSD Culpul 

V/ ini* Soft at: - 



ell (|; 

4 - 3; 

whit e |l | t 



// update ADC tnuUf (£ ant ex 



7 r\c ■, i n e 1 



t ac l a I ■ aei IAPC * s - 3 I ; 

// o;e*. dat4 rtca input pipe 

1, | 

iajmi r er : T-»- * I - oeí t tp- |> ; 
t uliile m> E : ; 

tf pneciv input d*t,a 

ílO c.bui rei | at *"*0| * I f LEO 111; 

=1 is anLCD <1 i ; 

i 1 <i o.bul ret | ; J ~~<j| oi r LE3 f2t ; 

clae inLED <*| ; 

í t íicj-utiíí; 3. i -- -a | iff LCD l 3| ; 

el ic an LCD (1J; 
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■* .' T^r-.vl rlflf o it- nuiptH pipe 

lOuffTrlOl - JHt^ry |1(; 

i Ouet?r| I | ■ j"* y ey I - ! ; 

iOufteiU! - ttpWCcy líí ; 

i&.bdttTrl 31 * »ilct 0| ; 

i e_but£?r| 4 | * idct 1| ; 

1 tjiuf ííiPí * cue [5(; 

d» I 

putr ipr- I la H t>ure cr | n*- 1 } j 
t prh<Í0|fy rj ; 



i 



//* 
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rue: uaeDEKC. ^ 

f lie. it j He vice - , ran r i gjnr a t. i on - j nd St ring *Dçscr ipiori tor 

tlSOOC Dene AppllrAClon {all remi DitA, placed in VUsh-HCKI 

Vec . : 1 - CO 

Auth: (CÍ 1DOG, 3DOI by Oliver Thaon, HCT Elcltc&niklAdcn Obi* 
https/ /h?DQveb . dc/utbOB 

Rn. : VL«/Cdlt thU rile riith TAB~3l3ce~* 



// 



tcnjft devij* 



nipt oe Devi r e^Citt 
rr ■? 1 1 pt 5 r | r 



■ix x ea f í devi íc, 

Dr_DE VI C E , 

| Quia, 3x01 i , 

n * 
D, 

O, 

I Ox TO f OxOc| , 

| OxOO P OxOOl , 

| OxOO, Ox 01 | , 

t. 

- 
1 
ti ft end of DeiriicScjc 



// Slxc or thia Deteriptar in Byica 

// Ocrciipi.i Type |-1> 

// USD 3p?r Rcluic Hunber in hCD ■ t.tO 

/ / Dcvlr: CIaij Code 4 none I 

// Device- Sueclaji* Ctdc<nene) 

// Device' tco-toroJ Code (n^nri 

// NdKiKUP r í cK pt Elvc Daz CfO 

/.< Vender ID * HCT ffl efct rentJtl aden 

// Product ID ■ Oenerlr Deoo 

// Device helea*e llwbcr in lic& 

// Index = f String Deae tor Ha nufa^t m er 

.* ■" Index of String Ocir Cur Produce 

// Index st String Dene tor SeiMc 

/ * «utiiicj cr pomtiDl e Confi-jurat turn 






renrt cinrtguut un.iunipt er conn cru esc- * 

I ft fllxe or thia Dercrlptor in Bytes 

■l scat {eenflo^urati en_dctc rlpt orj < 
or.CaHc 4 : atriXAFioti, t / Deacript or lype |"il 

I jrixeer tcann wi4tnn.i«nut erl • six-eof lint er race_de:ter ir.-t or I - 
<iixrot |endpolnt .deie rt pt er I * m xeo t fendpalnt.deicrl pt or I , 

OxOCJ, // Tetrl Length of Oita for this Conf 

1. < v He of Interface* supported ey this Conf 

1, // Designator Value for *thit* Ccnf i qura t i en 

O, // Index of String Dene for this Carlf 

OxcD, ff -- f*i r -paw ei es, ne Aenat. e~WaK eup 

D if H*H * f ::v*r 7 .n aut.p'. 1 in In t hi I Tcnf (*JnAl 

|; L - + / end er ContigDexc 
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rcnst tntTrti ^e^dej^f i p i n r ir-t ;(ri.-»L*r.- * 

I '/ !itc qI this Ucrrtlpt«r in Syt« 

II?CBt (l nt ETC 1i:;_:!Cflcrl p » r r I , 

Dr_I«rKWAfE, // CMfilpi n Type (** 4 ) 

v a ft rluntier of *thif' Inierrflr? IO..I 

6, // Alternative tor t hi * Interface hi any I 

3, / / Nc n í EC* used toy rmj if (excl. Err>» 

Oxlr, /* ir ^usx D«4c lOxff ■ Vsid«i tprctfi?) 

Ox&l, ff Tnterr*ce Sub^lait Code 

Oxlt, // ir Ptotecol Code (Oxfr ■ Venanc ipcciful 

D /y 1 ndex if ^Lrlna Gene tet ttili InlerfiK 

I; ,' / end er Inter* ictiiexc 






ft nji endpo inl .flocript or Etidpoi nt iDci c * 

I ft 51» or thl4 Dcr?tlp(4i tn Dries 

*l rctt f (?ndpoi nt.drir r tpioti , 

r>r_KK&rat«r y // Dctfiipt»f rypc l - ^> 

Cxol, // Endptmt Addre** ISM, IKJ 

OxDS, fê Interrupt 

|OxO0 r QxOD), ft Ntx. ffndpDtnt Facte) Slue 

JO // Folllnq Intctvfll (Interrupt) an r»* 

I; f/ end or CndpdlntlD«r 

rtnít en dpulnt.dcvc ti pt or Cndpol nt 2D eve * 

I // Sixe or thla Descriptor in Bytea 
*l leaf {endpoi nt.drt cilpton t 

: , -r._r-::ícr;;:íí i // Descriptor Type |*^> 

OxD?, // Endpolnt Addrer* (EPS, OUTI 

OxD3, // Interrupt 

luXOtl, 3xQD| , y/ Hak. Endpolnt rdcfcct iiie 

10 ft rtltinc Interval ftnterrupt) in r»v 
i ; '/ end or KndpaintAQcrc 

// Unouaar ID* 
fdcllne SDOLSK A 

i-Linat uchar fit rinaDDcvc | fiOOLCK* - | 

it ILxc, Type 

fiDDLSH^ Dr_firru ho, 

// itnalD Code* 
OhO? ( OkD4 
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i 4 ytinutdcturci Sttmg 

,, 

ídíí Loc SOI LEU Biirof ^ KCT Klektromtti 
,, 

renvt urhtr St rlnjIDcif (SfJl LEH! - t 
// 5ik, Type 

m, Dr.srni wo, 

: S^ r l na 



*-|*a 



fib 


1 is n f 




u 


fll Í 


' H 1 


F 


* 


i .■ i 


F 


D, 


' r 1 


f 


* 




■ 


* 


' R 1 


p 


- 


' 1 ' 


f 


- 


' c 1 


f 


■ 


' k ' 


F 


• 


' i ' 


' / 


D* 


' r ' 


f 


• 


' o ' 


f 


* 


' n ' 


f 


* 


' i ' 


f 


&* 


• to ' 


f 


D* 


' I ' 


/ 


o* 


'a' 


f 


&* 


f 41 


f 


* 


' e 1 


' / 


D, 


' o ' 


f 


L 
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let itnc 



j = : tt\*z CPi Lt^i 



»C ('U5DDO Cvflludtion Ocdrd 1 )'! 



'/ Etxc, type 

híuh, er,srw ho, 

.* Umcadc Btring 

»', O, 
O', D. 

a', D, 
!'*• D, 

t r w D, 

a', O, 
n' F D, 

»'/ P* 



// TJtoic *f Jlima Dcxetlplgii 

uchA t * camt Eí ri fv^" urT4 D! c| 
Jt rinoOQcie, 

St rtno2Deie 
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// me: tíOívse.r 

f/ ffunc: tt*b :n? i er*er*l it i on Module ror r-r*,ji Deno Application 

/ ' Ver . : 1 . CO 

// Auth: (Cj2DD0,2Dul by Ollvcc r^dnn. MCI iietiTonifcUieti Obft 

/ - http:/ /hcDOveb . d-/uibOP 

/ < he« ■ : Vt e»»/Kdlt thif file mih TAD 'Cur* 



//< 



finrlude a uDStiflki.n p // r?rtmnenx rt: USD D«ta Types t constin*.? 

flnrludc 'uOSdcir.c' // ronit U3b Descriptor D1L4 



. >J/ Bbuko "ode Apt i on ™ vet tr i ■? ejui t?ú by Mar rj*-« t ^ I 
ft 



'define U5S_I ruei 



// Internal full-up Enable 

// l-en«bl?^utc build-in ful 1 -up ftcslstsr) 
// D~Dlsable Icxtcrnal rult*up i?sui red) 



// — Variables 

volatile uchar aSQ_Htabc: 



fdcflne HAX.rXSUT.itrK 16 // nust be ;'xl 

volatile uchu TxDurccr | HAX_rJCDtMT_=M JK1 ; 
volatile ucha r rxtiur_rtdldx ; 
vol at i 1 e ucha r íxSjí _Wr 1 dx ; 



f define HAX_rOCDVr_;;i SK 16 
volatile ufhar P*n ii c er 1 11AX_ rvy 3i.ttr_ = : I ri l ; 

volatile ufhar flxDur.Adl dx ; 
volatile urhit HxH .: _vi: : 4x ; 



// nuat be 2**1 



volatile uena r 5us t -ndc njm ei ; 

set up_tii f f pi íeí up nu f rei ; 
uc-na r * Ef*. up tat an v; 



íicVtã t R37equencr; 
.-■■-.■ r resequence- 



// PATAC/l Meg fair EFQ Rx 
// DATAO/1 rieg far E1-: Km 






■ ' rarer sr*n Condition ror CFD (both TH and OUT) 

íf as a Response to an invaljd -ErUF Request 

// riius Kill be iuto-flu red by the next CETUr ToK« 

ft 

void fní^-írAit |) I 
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// 



Adeline t?HDr*oiHr_rtALrox(;o 

fdEÍlnc Ur EHflt" 3 HTOkDI 



// P LKAi^fEAr UIU£ Standird Lcvl:c hequíFt MdndlEr 
// called ey htntit ciET'Jr u ; 



fY 



i rr«turc O 



// ehcetc O-tiel^ 



;ctupOur!ei.ii:ndFx.hi J \ 
^ptupHurtcr.Ht.cnotn.hi i I 
ScttipOuftcr .* Lenoln . 1 i:-t 
r*>rff eSTALL <> ; 
?1ev i r HSct uptluf tee . b»Requ?f t Tv^c ■" nr^EH&P 31 HTI l» 

Itet upButr^r.vViluc.U *" SH&rat Wr_IÍALr> 4 I 

| f Act -j t n Hi rci.vlndn. 1 o-" ixoi > i | iSctupdui rcr .xt ndst . io*'0x03> > > « 
// ci?«! CPi/2 r&rcç STALL Pit 
if --iMipftuf iffr.il ndest .la ■■ -3xal J J .' ■" *M 

ITCnl h* - |DW_n SEL'-OH^STALLl J ; /.' clear STALL, Scqucnffc - PATA O 



P^F?^ucncc * Of 



// rlcdr STALL 



I K_T *>SE O ^ 



el ic loECcSTIiLL 1 1 ; 



ítip-ty DATAI it next I M nthdtcilan 



/'^ 



/' called oy i.i^Iffiir'ir u ; 
vota act Addrejtv t) [ 



P-;ii*a' FM fldl V 



if i sccupourier.it;ndFjc.ni | 

Set i»p3tif ter . x £ nJffx .lo | 

£etupBurfeE.Ht.cnoin>ni 

Íctyp3iir tcr.K Lenç/lti . 1 c 

HcLupDutfer^VAlue.ht i 
| Sec upRultet.vViluc.U * 3xB0> I 

£oreeSTAl#L <> ; 
et ve ( 

// prepare to vend ffPft v !>AVAl tt ri« 

urtta * DR_rDsco i o«_ncoc * o; 



£ t III Hi 



■' : - ;. 



// 
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// ser_?t>Mr : jubati ch Stcndtid I r 
' *' cat 1 Ed try hinfllcSCrjril; 

vfl id a ct Con f l ^u rtti on ( | 



i :* l* 1 ".d'jii'; nan&l ei 



it i sctupour:er.tt:ndFx.ni | 
setvifSiif ter .nT njw .lo | 
Sec uptiur ter. uL en at h. hi 
ie! jfS'.ji !ei,w Lenath . 1 1> 

4 Sec upfiu I tee . vVi 1 uc I o 



or f-;rxu <> ; 



. í ííeí up our f ti . vVa t u-.Vi - ft J | 

// t... need i c TEitcfilicr the ^«ntLQurcflen Vtluc 

// slnec vc support only one: Ceníl^untl en dnyrity 

U3B_3t«te * V£_COtfr I ntffttlO; 

/v ArtLvttE Interrupt Knlpnt.i j, reset STALL and DATA-regale 

UÍIU ■ i«_rXIK ■* D; /' ttPl Tk Kmtlc, Data SHE Is O 

UCIt£ - BH_KX2C; // rr: Hx enable 



// Zcra prom: go n*c(e t a Adressec 

J5D.;ui- " US_AftDn£SS£ft; 

UCfll * Df // 



St ate 






// prepare to send enpty HAIAi 



: i next Mi Transaction 
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■■'.* Dttr_SK5CRI rrnn St ind* td Hev* cc n?qucvt tUndler 
// ciiiPii by i.iíiríL*"íí"f *i ; 

// 

voi d get Dercr kpf &c | I 
uehtf n; 

iMiOi (i-^. up a lit ter. «Vil ue.ht) 1 

caie Cr.CRVlCS: // Oer Device DeittirLBtai 

SPlupDitdtt r ■ till.; í * I iDnrlccDnc; 

breifc; 

itic Dr_CONriQV»r\Art OH : // Oct "cnílaunl ten DcvcElptor 

£ ef upSi z? ™ Confl jD^tc .wrot il LcftQt n. l4j 

tr« = ; 

cave rr w ?rrtl»-': : // Oct "IttKiq l>-i:itpipi 

//' **• Table Ihjpk h^uiníííy kliould be fhcckcn 
SetupD*t4f( c - St rinaBe*eT4ble| Set up Butter .«Value. UJ ; 
SctupSix? ■ 'SrtupDinrtf: 
b c«t j 

1 1 i Setiuptlurrec .«VAXUchl -~ EJr H DBVrCR i i 

^ct'apQut !» it >Viiuc.iii m * & r.iONT i aim-Art on » i 

SctupSurter ./Voin-.m ■■ aT^STHt WO) | 

f- checfc if irqucarcd length Is (era tficn Dciertplor Length 

; I < t'rtupOut Ecr.u Lrnqt h.Ja t ^aupfl xe| hi (Tec upDuf Eei .VLraqr h. hi *■ Q| ) 

SelupS: xe * £ ?.* vipDvif tct.v Lengt h.lo; 
() fapv lup ta) B Oyt» to CPO Hat o neqmcrt 
n - O; 

dc4t * (uehor *|tU£0DD; 
vhLlc{lctupSlxct H Ú h- d<V| 

'de»t ■ * Set upD«t ertr; 

devt l * ; 

SetupDturt tl - ; 

SclupSixc ; 

n* + ; 

I 
/ / p trpj te 1 ■> x end n Hy £ e* ai DATA 1 at ii^ki IN Transact ictn 

// Hen: toidt (currently disabled* will be xe-e«abled at end ot hflnfllcicruf I t 
UCrXQ ■ tt»LTD;e& I BH.TXQE * n; 

'/ check IE itiu id the la*t DATA p« eft et u send 
t f <n ' a > setupSijfier . b Cheque* í * ltEOUC5T_70NrU£rtt; 
* 
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roiti hancJteSCTUMl 



Ut H3 ■ aHJlXDOtTR; 



// bncilvitc KFC ftecetvci 
fj React CPO Refcivr FUo 



Set ypOuf f et - * tjrtup^buf ter r > itUBODO) f 



//' CKrUP rronHeuen mirt be DATA3 »Uh 5*3 

i:tii^c*np hc htvr dn Kíioí "íttdit ior* 



ir lusna i- ax4^> i 
> 

el ice i // nov ve wiii cheek the Request Type 

í f ( jSempnut ter .Mthequedt Type t OxtO^ I" O} ( 

faree:rALL||; // Kan -Standi id hequcktr vltJ net be nsndi-iil 

I 

eive * // Vtindflrd Request Decedei: 

swurii ire-. vipCtif fer. bhequevk ( | 

t4BC CltEA^PCArJM: // 1 

rlei rtfcdt lire l\ ; 

breik; 
-fl=e SEC^AQDRGSS : // S- 

■etAddieak <) ; 

b r e« K ; 

»ie ctíc^tjr:^ =p,í r r^R: // c 

ejet 3e« rriptdf O i 

b r e* ic ; 
rtie SCT^COKr 1 a'irvATl 3H: // 9 

s et ?i?n Jlaont l cn 1 1 ; 

bretk; 
iJeTflu; t : 

ro r reSTALV * \ ; 

b r e« h : 
J 



ocne i" r»w_nxon; 



. ' V Activate RTC !\etet-/- 






vold hdnttl eOUr (| l 



ui r: * OH_RX£K>tfR; 



// ^eictlvite KffD Kereivt 
// Rnet E7C Receive flc< 



Z~ l &t\Blli ILI 



// our rrin'tcUcnv over cro «ppetr am im.u.i 5tij; 
r^ at j p*. aftSítí Device Peqitevl anlv 



UCRO |- r>H_RXOK; 



// Activate KfO Receiver 



// — 
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void h4ncii-iH|> | 

uchfl r n; 
uch4 r • dent ; 

UCftO E" *9H_rXOt: // Ducilv«te EPD TrtninltLer 

Ul hi " OK.TXODVH; // fleaec Cro Trimnit cenplelc Pt i 

twitch {Sec uptiurírí. bfietiuetit * ■ 
ease SffT^ADDhCSS : 

Ptap USb_Stft? * U5_£KrAULr; 

foie iEr_C'Kri:f«jrro?i 

// ccpr Cue 14| 9 hytEt to Era net* Registers 

n * Oj 

dcH * lucht r 'IfcVKODQ; 

HhllGiSctutSiic^C 4k n* OJ 

* dest * ■* SetupDat iMí; 

dent C - ; 

:«upOfllflPt r* *; 

ft* -; 

/ *' p rept i: ts lend n Qyl cv it next 1 IÍ liflnafli'i ; :' 

// ■ - :.- ' A1 ►■ 

U7nO * I (UCRD'aK.TOSEQ) k n^_r;:^rgj t rm_rxcn: * aK_tvxo& ■ »-.: 
// íhp?í if thi« 1» Ihi last DATA pacrtet to leni 
1C (r í fc I Srt upButtcr . bttequewt * RCOUEST.CO Kr 1CT B ; 

fíí? c LCAh^rrcArunc: 
case sur.courr CURAT I O H : 

// nothing t» da- * nandshok= finished 
Sctup&ut trr .bitcquctt * ttigtiSSr^Conf l.KtK; 
ttr«t; 

// ncqueit is cinivhcd * Just clear the rxODiT (flag (see above) 

■ ■■ and do nat icchiblc £PO Traitinttri, xinrc th?ic in no titic 

// data to oend 

b r cd t ; 
default : 

rarceSTALL 1 1 ; 

bcea t; 
t 






US 608 Evaluaton Board Designer Reference Manual 

MOTOROLA Source Code Files 1 09 



Source Code Files 



// handle ZU tajfcet ri 

void honiílelííl t| i 



■it It. 



Jlet i 



sri 



pi nrt * a«_Txturi*i 



// Ductxvitc HFl rrtnnittel 



rii 



n - C; 

v. :. . : - i ■ - kB , : R a t 1> I 4 rxOijf _líi Í 4x> EC r»*lt> I 
* dat * V>,ni.i rcc| rxKui.nr;:^ ] ; 

rxOtif.MI dx ■ irx»ur__RiJI dx*» 1 1 * |NAX fc rXI»Ur_filííK-Í ) ; 
deJt - - j 

i 

Antvaíí sri TcantnlLLcr to send n B/ta 



/rf 

// htndlc 3Ur Packet received aver Kf7 



void hflndlcOUTlj) | 

ucftdr netttdx; 

uch4 r • a re; 



UCR3 I- -»H_PiX2t; 
UI 112 * aH_fUCD£P"lV; 



// Rcítt KPJ Receive PI ci 



• t# Sender'* DATA Tsoole jhcuU t»e rhcdtcdl 



// Check rr«nvrtt 91» 



'r" read out EP2 Rx Hot* flvJíícr 
dire ■ tUE3DO; 

tfhileim 1 

ficvldx ■ idxBuf _Wrt dx-tll 4 fttAX_fOC»UP_^:j ZX~ L > f 

vhil e (nevJdx -*- ttKDur_R3l dx) 

// wall If rxDuffci 1* full 
ttxfiLir t er | i\x&jf_t(i: dxl ■ 'ire; 
-J4!i-.:i _mi-: .w ~ newldx; 



ci — ; 
1 



// Acttvttr ITP2 Receive» 



//-- 
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wc no ■ a i 

UCM ■ ilj 
UC112 - Ci ; 

*JSa^l PUC* &«_?*Ut.LEN; 

uino " O; 

t-'in: * QxBC ; 

U5B.S14CC ■ U£_rOKKIUH); 

VxPui _Hflt dx ■ O; 

Yxtfuf _Mt I ix - 0; 

!*jcrnír_r>dlíix * O; 

flx&uE_Mr I dx • ■: ; 



// U5tl ríiibi-, deCauU adâreia 

// r?«« SP1 

I reaet B?: 

/> cXroc rXJST riao 

// cntb: e/4iviMG Lnttíi-»i*i rui ; -us 

// USO nnrodl upciAt 1 un 

// diííbií lnlciruptJ 

// ctfar 4!I rii.-j :.. Ulltl 

V EPS ílx Jtuta vlth DATA& 

- rr? S\x siiiii vun HATAO 

■' * (aw-; ^i, but- not yet i wet 

// fpaíE Durrcr in^-xe* 






ur-ncr octU3no < 



U'^fiA ! 



win i - tPxHuf.rj; 4x -- ttxbut^HrT i« I 

; / / irate ir t*xt*«rrcr in wpty 

c * Rxaurrert rtxBoT_í*iiI ix t ; 

fvxfji»r_fi3i dx ■ ^pjiduf _tr j 1 wi!' t tWAX_nxrnjir_fff 1 

r it utti z : 



1-11 J 



void putiíSífurhn e» 1 

'.u"Jii i nn 1 dh j 

ncvIOx - tlxfli:! _M r 1 m • 1 t t iKA>C_Ttt &ur„£: í? - It : 
-hiIc(n^ldH »■ rx3wr_fldt dx> 

Í /* vdlT LI fK&'jfrcr is full 

rxBuircttTx hur.Vildx I - c; 
IxfJu r_*frl *»< - norTdx; 
I 
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// UEQ tntPimpt Handler 

' Ail tntnrupl Seutcei ot thr JE 
/ '' hJ.11 be treated by tnu I SI* 

• interrupt v<rld iarU5b{) + 



integrated U5B pcnp^icri l 



ir iu:m i tJN_rtcrri * 

else i r {Urftl V dX.KXDOEJ 1 

handle^Erur t> j 
clue 

nandl pOUT U ; 

t 
el ice iriUIRl b BH_TXDOtJ i 
handl elW n ; 



; 



iriuxm t Qrt_TXDirj i 

tandl el«i i + ; 



// End »f ractrl ict ret edr 
// rejret Jvi*5uipcnd Counter 
íeaet EOr ln=i ritci 

// hdi EFO received acrte datar 
// V40 It i £CTUr Pa^fc-t r 






vi:&u uur ricuct 



:nt c 1 1 s : 



=ri 



:nt rtt-i: 



ei ice i r tucnt i oH.nXDsr) t 

nandl cOUTl () ; 
1 
el ice if [ti:M i OK^HITFJ I 

urn a i ■ pH^cMAPtn - ok^nabicí; 
trine ■ &H_rxD2ic * cH^t\xrait - 

: v: ■ :i ■ r : t; 
fICfUl *" BH_HXatt; 

u;a.stdte * us.oarAULT; 
1 



'/ hdi Era received Datar 



.■' * USO Run ^ur.ti State detected? 

// roft n»et or usn s/vlui 

* ' t^nible CM and Bra 

' / era I*x/Tx Intr finible and 

'/ cri Tx and Era nx Ini t Enable 

// and Cnd-or -Packet Int r Enable 

. ' / era Receive KmMc 

Levi :c i w peered and revet 



/.— 
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U0B232.C 



// rile: UQB23£.r 

}* ffuoc: "i^i; Upiencntation Hedule tci U58DB Dema Apptlcttlen 

/ i Ver . : 1 . fiO 

// Auth: <CJ 2 DOC, 300Í by Ollvee rhdnn, MCT SJrKTrontKlfldcn ObR 

/ ' hup:/ /ncOnvel» . d-/uibOR 

// hai>: Vm/Cdlt chia Pile with rAfl + 5iiC* 





íinrludr 'ncOPiiir . n" // MCDBIBft Reel iiei Pes 1 nit Lena 

(include ■uoa;)3.h p / •' Headei rile for K3232 Medule 



// (Hmvflrr Dependencies * thymcil Fork u.-jgi rar CoftiroiE Swl Tx/Bx 
// rhi rig? Che f alltwlnaj DellM^iarm to tieet i'iut Ha tdvare Pe^yi letients: 




// Trtninlt Line i» FTCI»! 

ídtítne aetTxLav M (PTC fi" -Dxtll | 

Adeline ítfTxKinhlí (PTC I* SxDI ) 
*J-!ine enirxDul || (CDRC |" DxCl| 

// Receive Line la nA| "'| 

#d?Hfie t«IUlvl || <PTA fc OnVOf 

'define eniPxlnt) CCDRA & m *OxBCI) 

// Hardv«:e Uepcndenrtea - 33CC Bit Ttnlnc generded by Syvter Tlner Tt« 
// Chinqe the tellewincj Dcfimt nn 1 to ncet youi )M t dva te l*eo,ul t erencar: 
U 

rl-4t T5T<tr Bit in rsc ltecil*tec te acclvile Counter 
/' C5CI..r£3 Pieacilec Bits in T5C Reolrtei nuat be D (default! 
if ao the C«unttt ftdte 1» 7 HÍU ÇQ . S33paJ 

if 9400 Baud -» 134.LCC0 ua pee Bit -' H3.3 Clock* pet Bit * iHm 
//' S400 D4ud -» 4it ( '(cr u* pee Bit -» 1230 Clock* pet Bit « iNn< 
/' Ad)uft Value dependino en Subroutine Tall Overhead 



// 
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. ú içiiyfííti&ii t> * 

// nibbHct - 20 Clcct* ror flvettn 
lab * 3 CLoek* * «OO Clock» 

Id4 1123 \n\ 

.dhbl : 1--: \ nv 

nsp vn\ 

tone dhbl \ n> 



void liiiyau TipcO 1 
delayHai ron O í 



/'■ 



; til t ^ 5CX II t 

tetrxtiieh t> ; 

rneTx&ut || ; 



// »et output DtU Ltteh *t 

ft enable Cut put Djlver tar Tu 

, r / Kk it in T rtpul i 1 r; e 






unti ji-^J ?rut n; 



rV dir«ttie;i<TxMI j 



■ / idvc rui rem Interrupt t: ; ^. 
// dlidble Interrupt* 



<-i tat Lev l) ; 

leÍ4Y»l-Vtne (J J 



'/ 



:d St ■ ct bit 



if <(e*i|— 0> 

« et Tx I a v < | ; 
else 

ictrxHi eh í > ; 
del iyOtt Ttrc i 1 ; 

i *hlle(~n> = 



' 



2flt46lt3, L3» filtlt 



■ Txnterki> ; 
■l-layBH Ttne 1 1 ; 
delayDit rine (J ; 
// set CCK (etr.iive) ; 



// send Stepttit 



' * ! e»t Hi p trvi butt I nt cr cupt Stfl n>. 
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/<■ 



cli a r : ■ t 

uml fined ;hai ccr.ttvc; 






// idve ruttcnt Interrupl Ha *fc 



4-tdyKi: f!iit O * 



/' wnt toe tt -1 itihíitiín 



// 



D 1 1. 4 t 1 - 1 



ttel ■ V»4t fificll ; 

c ■•- i; 

if <t *- fV* tvl I é I" -3) 
e |- oxD'J; 

t wiiileC—n): 
dcJ a/0 itriti-ft j 
ir nottutvl f| **oj ( 

// tda riantn? cit;r 

> 

/ rf jFcrtCCK (rcf„a*vç) ; 

irt urn e ; 



// eherje ftx Line lúrinq St i 



// fntit^ prrviom Interrupt í<a = *■ 



f/* 
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ff rile: yawtY.r 

f/ rune: Key Input function* tor f JS&Oe 

/ ' Ver . : 1 . OQ 

ft Auth: (CJ 2DD3, 2001 by Oliver rhdtift, H7T 5J-tUohiKU3cn Obit 

// hetp:y/heDovcb. ú^/uibOB 

// Rot.: Vim/Cdlt thli rile xuh TAfi-£lie-4 



flnrlude ■hcCejitG . h* 
Ijnrludc "uOOfcey . n* 



/v __ □^ctnttii 



/' Spceitlcdtion aí 'aclive' Key Input*: 

rrA|4,^,C| * IQJlLOODO * 0x70 
// rim Kery rennected to Tort flit J 



fdeítne ttKV_tlA^5. -SxTO 
'define KCY_ffIftSr 4 

/' Vflr u*ed. to tract the Key Statu* 

ki»*a i jr. ca cha r is ey fit a *. ■" ; 






vol n l nt t Key (> i 



root |" DxDi; 

rrfi i- rrv_WA5K; 

DDrJA I" iCY.f*ASK; 

DMVA *- *r£l_HA5íí; 

Knife* ■ rt:v^«fc;K; 

K9SCR * DxC'i; 
KeyState * O; 



entble f t A rullupv 

write 1 to Output U t rhei 

output «-Level fulte 

tack D Input 

em bte Cnt cr rupt * 

re*e» ACKK U*s#t tn easel 

rejtet inteiml SLiLut Vtt 



rh*r sjet Key lunntgned char xi | 



x t" rtrr_rirtsr-i; 

x - ; *• x; 
Lr (KeySt at e b x> 

retu rn 1 ; 
ret urn fl ; 



// calculate Bit fo*itlcn 

// create Oit NivK 

// teest the relevant Statu* Hit 



//«» 



fir. terrupt VíiJ iSftKcy{> 



Keystate A - -tem 
KElSCct * Dx04 ; 



-KSY.HASi; I 



// react ACKK (Cor none varety e<nly) 



rV™ 
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U08ADC.C 



// rile: uaeADC.r 

// rune: SQttudic ADC Foe USSOfl 

// Ver . : 1 , OQ 

// Auth: <CJ 3DUC, 2&QI by OUvee rhan^, MCT CJcttrontKLadcn Ob» 

// WLp:/ /hcOBvfb . de/uibOtt 

// Hen , : Vtw/Kdlt bKia rite tilth TAB-Si xe*4 

// 



finrludr *h^CD ?bc . I**" 
linrlude 'uOdade. n 1 * 

void imtSADCjl J 



■\* d*>>cat*le intemil rull-Upi «n PTIE 

rarn I* -cxoa-// diidbie t-m li* 



umianed urdi eSADC lunvi oned t 1 . umi sned 13 1 

tl - ' " * ; 
l J < * m - < ; 

^affi» rpohi* I ; 

.-rurpulh"! ; 

_a»iJ-l-lK :,jp")j 

.>-ni|«Mi C,-p->j 

.flm'"dtv , )i // A - H:A/X 

_fl»nrclrx'| ; // D;A - t3/tl 

I 

' 

int j-t 5AGÍ i.eh* : channel» ; 
unvi jíi-í "_ &, kl ri tap 

unvl^ned v^litlle xz; 



/ / convert chúnnel f 1/3/3 re CWQ1 / *JkO^^ GxO^ 
i t \ i*btnt)el ** J) fht nnrl * * : 
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rtlibrdtlon *i*cJp 



VT& * - -t)x7n; 
DDJlD |* Dx7t)f 

rrn i* 3*07: 

DDKB |* DxD?; 

ror ijr*-0;**-lOOD;«-» j 



/' rroi i. -ot - l 

// Output 

// FHItt»,»?] - rt; 

// Due put 



Diin-f I- ~ox07j 

tO* TCMt ; 

* i. . : - i ■ P 1 E * channel) I* PJ ; 

1 1 * rc« r ; 

t 1 * tO; 



V itk fitar i:r.pLtt | 



// 



i c^iii Jit ;cn :ycl e 



DDKE I* Dx07; // Output 



// rrc «ir im^i i 



DPHK I* -0x07; 
tO * TC«T; 

tthilcl (PTE i chtnncl) I" t>J ; 

t3 * rc«r; 

ta * 13 » iO - ti - JOOj 

Lf rt2 - 30DG0u| 13*3; // unâcrtlatt 



ft *•' cflLcuUtc inlcd rcruU •*' 
(3 * ac«l cSASC <ti , I 2) í 
r?1 urn - - í 
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' ' 



itiTKSiwrr VBwron; tap le vcn ncvoaji 



r ■, v >i 1 



• ' i t ■ n\ ■ : - , t i ne 



o<t em void l krCunn/ | ) ; 
Oftífn vol 4 1 >rU?B I 1 ; 
//oftçrn vflid ts i\erat Ett I » j 
ex t err* void i ttf.ey |l ; 



a *• pittit 


_vcrl i 


t:; 


lit 


II " ! 








; itKpy, 










1 Keypad 


•' 


, ■ r bunny , 










1 riMEft 


, *í r , ; 'v 


■/ 


i * ; D Ji" ny , 










1 ; : :^r. 


i*ftannel 1 


•/ 


1 *r&tj«fiy r 










1 TIMfiP 


chennCl O 




1 * r LnUBfiy, 










1 ; I», j i 




'/ 


Ue USB , 










- -jsa 




'/ 


1 ■ r : :í- r- x - f 










1 íw: 




*' 


.ttott, 










1 tucscr 




't 


i; 
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CRTSJB8.S 

; ^«pycght |c| l3»3 by COSMIC ^«llvdic 



x r ri 



^f>< l n, 

_M 4 t , 



iPtKH*/, *t tCfc j ltiT'3 B J Ct t 



íick: 



«1 rxt : 



fr kticK 



iniufiliic at ccfc ptiiii i 



elr 
aix 



ene 
ld*x 

JVC 

_exlt : 
or* 



9 

I c: 



O r x 



» *t «efc 

_ Ttí í n 

_CHlt 



*t*rl ; :::[■ 

.- : * j r byte 
next bye e 

up t o i he end 
and 1 cep 

Lmt lallxe »c acfe pel nt i 
execTjt e t*i in 



) n '4 ft ay Here 
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USBQ8.LKF 






eu, .tat - b txifrcd ~n .toti 

CQ . Cí Í12' - a ■ t eXt 

ro .D>rt -b 0xDQ40 n .birct 

rg . ub vfiE ~a .bvrt _ n . ubrrt 

CQ , .1 i I .1 — 4 ( '.itJ:l 

=t íbx*-# .bafe 



E^innnl* foil ow rode 
xcio pig? attrl tddro 
4im ibdrt lOdrat 
dit4 ítsti iddt-ix 
■it a 1 1 tdlicit DC Caa 



* rut yaut vt Att up rti? ner t 
rrttj&n . o 



V startup r our J t 



• Put yiot ni^s here 
uOBtt* in.o 

*** : ; -çt tigtihfVfsiPlcyraOB^ ItbMitt .h^fl* 
■r: \ptognM\ r«mlc\ :xOf\ Llb\ 1 ibr». hCG" 

• = 5C . const - fc Qx í f I i V vect tta sian addrt 

• Pui your inter rupt vecto r* m^ ii~ * e if needed 
veejbtl >a 






V *yiit»i-I used by library 

f itact polMci iniUíl Vfl lut 



BUILD.BAT 



i-ytOQD ~v *l uDDniln.c uOflfldc.c udMcy.c ve?jl 
rlnt -n usoOS.mp - ■■ uibOB.hDB uxbOB.Ul 
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Of 



i- . . :.i ■ ■ 



£ tz 



IlltK C 1 1 I 



■bOB.lfcr * Sun Jan Q7 l*>i2*slO 2DOl 



Eegnetit a ! 



*t» rt naoaarOD 

*n re DOOOcSA i 

it e rt DO OCO O J O 

ttt Et DOOODD4 O 

■rts rt DOO0OO4 1 

»t e rt DO uca O* 1 

art tit GO COS C CD 



id OQOOcir^ Iwolti 

id G0OO0O4C Icncth 

id 0000004 1 lengtii 

id OOOO004 1 length 

id OQO0OOT5 length 

id OOOlDOOD length 



ifiT^ ve^ncnt .text 

l *if. ic^it~nt >conit 

D itfrtent .bic* 

1 vegrtent . uMtci 

O vegnertt .d&tt 

OÍ leonoit .bar* 

J ft tcgncnt .conn 



flBdUL ■ 



cit tf&«. or 

rlttt DOOOdcOD end OOOOdc-ld lengtn 



z? 



E-n i i 



. t eXt 



xt-trt OOOOdcl d end OOOOeDeD length 1219 icrt 1 i 
start D0OQ0O41 end 00GOC074 length 51 t ert 1 i 

>t«rt DOOQel^l end OGOOeir^ length I4fc recti 



« t ex*. 



. C LtlAt 



i.ont ey . 3 : 

vtcrt DOOQcOeD end OOOOelJS lenoth n icrt 1 1 

fetiit 00000074 end O0O00O7& length 1 icctli 



. : -'. 



uoaade . 3 : 

run nooOrlll end OOOOcSCl length 



iu* 



ten inn . t ext 



: : \pr< 



>r*e\ es»Bti\ cxOnUibMibn.hM)! 1 



riirt ['goaaiMP ena g^vo^^i length 



:e:l i. 1 



• ;!,,,! 



riirt OOOOfttD end 00O1 0DO0 length 



j c 



:cí i cr 



. e Lit^i 



n 1 th uai 



lion **j* . 4 : 
_get5ADC 
.ir.i'-SAS 1 ' 
_»ealeSAt^ 



l*3> 



kjOBfcey » 3 : 

_t nit Key 
«torEey 



* 
2 



mi n ti* in.o: 

^_tiroa»etup 

_(■! ei rF?4tbie 
_faiceSrAlL 



[3| 

L2I 
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.tjei Hifc rl pto i 




1 


l»l 


«etUStl 




J 


HI 


hind! ctfl 




T 


1*1 


hindi cl III 




3 


1&I 


.htt.j: eOUr 




J 


1*1 


hindi cOUT3 




A 


1*1 


.hinil cSKTUt" 




9 


LB| 


i nit uso 




3" 


w 


,i 4 iHunry 


* 


a 


K-l 


.1 arUSD 


1 


IT 


I0| 


.Dim 


■ 


1 1 


|13> 


put use 




3- 


ID» 


aet Aadrecv 




4 


1=1 


id Conf tjui4 iur< 




4 


1*1 



11 CI 



.Cont i yD?4c 


^ - ^ - - 


d-íjncd 




tlORfitln 


r o 


aeet l on 


. r nn rt 


^D rv 1 e eG eac 


3 GO De2 J 


deemed 


In 


uQffooln 


. b 


meet * on 


. - i%n n 


_C rv !>pi i nt I S ea c 


Sec peji ' 


defined 


m 


14 J IT t\ fl 1 n 


r O 


aeet t <tn 


. con rt 






* * ■ net 


uacd • • • 








.Kndpa 1 nt 2D car 


3 GO C e 2 o e 


defined 


tn 


UOBDftlfl 


. '1 


■ed 


. riitirl 






' • * net 


used * * * 








_lnl rr It eeScar 


S*--o o-r." ■ - 


dee med 


1 i 


UdlflA m 


. "1 


sect: ton 


•?entt 






* ■ ■ not 


uacd 








.tíçyStatç 


3OO0DO74 


dee ined 


in 


u3&Jccy.e vert t en - 


b*a 


^ftO 5 e ^ti ene e 


3 OO DOO 4 3 


deemed 


án 


uDflno 1 n 


r o 


aeet i on 


. & = * 


^tm 5e rjuen^e 


O OO COO 4 1 


deemed 


1 i 


U^flflA ICl 


. d 


it eet t 'in 


.baa 


.RxBuf.Hdl dx 


3OODD03O 


dee ined 


. ,. 


u£7Hne 1 n 


r O 


icct i on 


.baa 


_rtxBu/_Wri dx 


3 OO DOO 4 r 


deemed 


1 p 


uOnoolo 


r o 


Beet i ar: 


.baa 


.Rxbuf rer 


300 COO 31 


deemed 


1 - 


uOPooln 


. '1 


■ ect i on 


.baa 


.Set up Bur ret 


0OOODO46 


dee ined 


1 , 


Li3iin a in. 


rO 


aeet t op 


.baa 


__r:ei upDildPtr 


O OO DOO 4 3 


dee med 


In 


ij-r na in 


d 4 


■eefc * en 


.■,.-: 


_£et u^i i? 


3OO0DO43 


dee ined 


in 


UOOnaln 


. 3 


aeet t op 


.baa 


_St r ingO Du c 


COOD?3»3 


dee ined 


m 


-i-Cr-ii»'- 


r O 


aeet t op 


. cunvt 


_S* íuiíl Da? 


0OODc2*>? 


dee med 


tn 


uOPfiú i ci 


d o 


Beet ion 


. - on ■:' 


_Hft tinglDac 


OO Oe 2 el 


dee med 


1 r 


uOOnot n 


. d 


sect i on 


on pt 


_»■ tlnoDe*r74Mc 


300De3ef 


dee med 


tn 


:i-Cri 1 n 


r O 


aeet t op 


. con at 


^mprndCftunt er 


3 OO DOO 4 c 


deemed 


tn 


"-rua in 


r Q 


aetrt 1 on 


♦ e = a 


.rx r*ur_rtdi dx 


0OO0DOC2 


dee ined 


tn 


u^oncm 


r O 


aeet i an 


.baa 


,rxnur.«ri dx 


3 OO DOO C 1 


dee med 


tn 


uOBndn 


. a 


aeet Ion 


.baa 


.VxDuf f pi 


O OO DOO C J 


defined 


in 


uOPoom 


. 'i 


■eet ion 


.baa 


_usr*_st it? 


O OO DDO 7 3 


deemed 


1 n 


nítíig i n 


. 'i 


■TP^I . :if. 


.baa 


_MCOd5ctuti 


OOODdf to 


dee med 


. . 


U30naln 


r O 


aeet i an 


.TCXt 






uaed rin 


rrt ■ ; pa . o 








_ . «ena ly 


O OO DOO 7 3 


dee med 


: ■ 


riRflAtlÚ 


ri!r xer-ian .bi 






i»cd m 


rrt a ;t>S. o 








_flt3s 


O OO DOO 4 1 


dee med 


In 


i- a nn a ii ■! 


file tcrt Ion .Di 






uaed in 


Lf T ■ - t J . ÍJ 








_BlJCfc 


-300D01 3F 


dee ined 


tn 


c^nnerift 


file 








iiici) m 


.rf .:jn,-. 








_llf)fl 


O OO Ode DO 


deemed 


tn 


et ta jím 


rO 


aeet ton 


t THt 






ua ed m 


VBCjbfT. c 








_VCCl OB 


3 OO D t T t O 


deemed 


* 1 


vcl-]cBiO section 


ctnat 






* ■ • net 


uded a * • 
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el e* rFPfltv re 


f3 00Dd7»3 


rjef ined 


exit 


300Ddelb 


acf in cd 


farcrrrALL 


3 OO Cdc 1 d 


defined 


.tj — t D?vc rlptoi 


OOODdrcl 


defined 


Oct Key 


aOODcl 0* 


def ined 
used in 


.3 el SAP " 


300Cel 3d 


defined 

lucd 1 n 


gctUSD 


3 QOOdrSe 


defined 


lundi »: íí 


GOODddid 


defined 


hind! et Kl 


OOODdeod 


defined 


hindi cour 


OOODdded 


defined 


.hindlcOtjra 


OOODdeeO 


defined 


lufi-i: csftrur 


aooodd*4 


def ined 


.iniiffçy 


QOOOeQcO 


defined 
used in 


initSADC 


ÍOOC-eí - 1 


def ined 
used l n 


l flit USB 


aooodri r 


defined. 


,i 4 i tmnvy 


icotdiif 


def ined 
used i n 


,i a rfcey 


SOQDcl =2 


defined, 
used l n 


i arUSD 


acoodri^ 


def ined 
used in 


DUn 


soooeool 


def ined 
us ed in 


put use 


OOOOdfTc 


3-f ined 


rt-AlcfADC 


SOOOci lb 


def ined 


»ei Attdee» 


3 OO Ode 6c 


defined. 


«ft CantiauMtitin 


aooodc^a 


defined. 


■ tcoj 


3O0Cl>040 


def ined 



nett Kin .text 
sect l on t * ex t 
- - - h . ■ — * ♦ 

■cet ion .text 

Erllon . t wi 



ten l en .bs 
sect 1 on »t i 



irt 1 4« -t 



4 t 
*t 

rci icn ht ex t 
iCirt ion .tocl 
rcct l on . t ex l 
irt l en .text 

;rl i en .test 



=d in 



t n uC nnai n . □ 
in e : t í jt.n .o 
1 n uQffoo in.o 
. : uQPnoin.o 

in n2Btey ( £ 

uCJAni 1 n . <r 

£ n uOe^dce 

n^Bni i n. o 

In uOPfitm.o 

I n. uOVoo lo.o 

in u^flndl^.^ í^ít i ar. »t 

I n uO Bntin. a 

1 n uOVno in.o 

in luBriii, ■ 

l n uOBk ey . o 

tid Dfit in.c 

tn uoaadc.e- 

uQffnc ln.Q 

tn uSnnAin.o 
vecjbB. e 
in uOVkcf .e 
veríBO m c 
1 n uti flnain . o 
vccJbB. e 
in UOBniln.0 
ir ri a ;e0. o 
1 n uO nnd i n . □ 
tn uOBadce 
in uQBoolo.Q 
in uOnntin.o 
in ^?: vprsgrflnnc 
iQctl en . uesct 
uOoni 1 n . o 



ÍCt í a[\ - ' CKt 

:t 1 en .text 

jet l<m *tat 
xtlon .text 



ícrí ion »e ex t 
lion .text 
:ct 1 4a * t ex r 
:ct 1 an . s ex x 
\ eosnic\«xO0\Libv iitn.hOCi 
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USB08.S19 

Ei23DcDD450i3r*4ci*srr9 4 300 4i2C0 37rAr0:6 3007 3 2&r9 4 30i3r9 4coE00i20rE4 300iA2r 
El23DC2OF6AA3OF7Êlc6O0 49 2S0rc600 4n260AC6Q0 4D2*0 3c6Q0 4c270 2 20i:2cSO0 46AL0 2::9 
El23rM026F7c60D4e2£F2c600 4A41Bl0 4Al0 2 2&i:9Aiai2609 4 3Q0 3cr5A43rr7 2Q0o4 300E4 
El23DC6D3*r6A«rr7^FC700 4lA&ACn7 3aBlc6CG4B26lBC600 4A26IG:S00 4o261lc600 4c2o 
El23DCe0260cceODÍ52607c600 49A3 30 270 2 20SEASACB7 3aeic60a4B26 2 2c600 4A26lD-6Dr 
El23*CAD0D4l>26iec60D3c2613c600 49 2*0EC6C0 4aAL0 2 2 407cSG07 3AÍ0 2 260 3CCOClOC6OB 
El23DCCOOD^e27DrA6O4c7G07 3A6 2CB7 3CA6I0B7l9 200 9A60 3c70O7 3 3r3c3rl9AfiA0B7 3a89 
El23DCEDBlA7Fl>c6DD4&4iaiQB4ia2Í6 4I0 32lCDDClD20 3 3AEE2cr00 43A6fi3c700 44A612 3A 
El23DDDD2D22AEE2cr0D43A67 3c700 44A6 20 20l4CE00 4a39BCO6E2Erc700 43D::E2r0cr0QOÍ 
El23DD2D44e7eAF6c7OO43c600494l0I074l0204Al0326 3D:60C4CCl004324Cac6Q04D2642 
El23DD^DD6c6OO4cc7OD33 9 57rA6 20E70 26r0120 27c600 43CE00 44B7eAr6 9 3EE0iB9 9::!:::S£ 
El23DD6DD*ieAF79 5ecO22&0 26cQ14 300 436c0i26017c4 300 4 37A9 37cc6CQ4 3 270 3r6Al0BEr 
Ei23Di>6O25crreAiiAOB73BraAl0B2 40 3A&rrc700 47A70 3Bl4 300 3BrSA4E:rr7A&0la7lflBcB0 
El23DDADAEDBE6lFD7DDÍ3 3BF9B6 3D4I4303CDOClD202 3c600 46A3fi0 270 3CDDClD2017c6AA 
E123DDCDDD4741D1DE41D3 I* 4106 LB 4L091ACDDC1D 200 3CDDC2 34300 3MfiAAl0r7B 1CDDC3 1 
El23DDED6E2DF3CDDCEl20EECOOC9 320E9 4300 3BEfiA4crr7Afi0lB7lBr6AAl0r78lA7ro4 3 3B 
El23DEDDDD3&r6A^DFF7A60 2B7iBcfi00 47Al01277 44LG30r410fi23Al09 276A4c276CCDOCl0 
El23DC2OlD2Oe7c6ODíeAAB0B7 3 9c6O0 4S270 4A60 3 200 2Afi0 2c7007 3 20 4B9 37rA6 20=70 2rr 
El23DE4D6FD12D27ceDD^3CE00 4437BArS9 3EE01B9 9EEE0 48Ar79 3fic0 2 2fi0 26c014 300 43A7 
E123DSÊDSCD126017C45D0 437A9 37CC600 43270 3r6Al0B2 3crB6 3BAB3OA4B0FBAB30B7 3BAA 
El23D&eOr6AlOe2^05Aerrc7C0 47A70 3 3lA7rD4 300 3crâA4Drr7A60BB71B9 37rA&2BE70 2rB 
El23DEAD6FD12D21CEDD$23COfi006 39 3EE01B9 9EEE04flAr7cfi0Qfi2 4CA40FC700fi29 3ficQ2 47 
El23DECD26D26cD17cc6DOí2c 1006 1270 5rfiAlOB2 3D 2Bfi3CA8BOA4fl0raAB20B7 3CA70 38 lEE 
&123DESDA7FC45DDl»F6A4Err7A610B71BA6 3O9 3E70 36E0 2B6 3EA40rE701202Bc6OO4E4clA 
El23DrDDA4DFF7clDD5D27EB9 3E60 2EE0 3B7BAE6CE00 4rSCD700 319 3r6c700 4r6cO3260 2A2 
El23DF2DecD2ÊAD16DD126D4A610B7I9A70 4BlA630B7 3 3 3E3B3E3c3El9A6 44B7lA3ElB3E3 4 
El23DF4D3&AGFr&71B4rc700 42c70fl4Í4cc70073 4ffC700fi2c7aflfilc70a30e70Q4raia7cSSr 
El23Dr6DOD50clOD«3r27FBCE00 30 3co6Q0 5í9 3r7cS00 30 4CA40rc700 30rfiBABlB789B7c6 37 
El23DFBDDDei4CA4DF95F7cl006227FBE602CEOQ61BCD7QOfi39 3E6c7006lA70 3aiaaB6 4010 
El23DFADB7DF3ADA4FC7D0 4EA6a0B7ia20 43013A0D0D3D05CDOO9 420 3ACDOOEO20 3 303 3A6o 
El23DFCDD3CDDDFD2D2DD7 3AG3CQOE3D20 2 3Q9 3AG3COOEE0 20lD0D3AlACOO?2r4300lAE6EO 
El23DFBDAAD3F7A&Ç&&739 4300 3&EâAAlOE7Aâ02c7007 336&7 40BAaOA62lB71r3EOAai9DB4 
El23E0DD6DA7F3CDDF2F430007A607?Ar7COE0E0CDEl3 39A9 36E09Ar0A9r9EE&0A972 40 3 3o 
El23ED2DB&&EecDlBAB&BB9 3E60B5r4c2fi013CCOEl3o3ABBr79 3fic09Efi09Al0 3260 26r09A3 
El23ED40^FC7DB$CDB&F^0&&4097 2 40 3Sa9Efic01BAB9aacODF3ESABBr79 3Efi0BAl0B2 3E3D3 
El23ED6D7D2&DB45DDD3F6AAfll2006 4 3000 3rfiA4EEr79 3ío01260B4 3000 3E , fiAA0 2200fi4 3S3 
El23EDBDDDD3F6A<iFDr7&36o0 2 260B4 30fl0 3E6AAG4200fi43000 3r6A4rBr7 3rA601COEl0fil9 
El23EDAD9^F7SFASD2CDEl06 9 3E7013EA60 3COEl0fi9 3E70 2Efi0AE70 3E60aE70 4E60CE70 3CA 
El23EDcD^FB7D6ecDB&F^0a&4097 2 40 33a9E€c01BAE€3FCOOF7c9 3E60aAl032 3E6CCE017 3 9 
e123eDeD450D1DFÊAAD1f7 430000E^AA70f7 43000 4EfiAA70E7EfiA4BEE7A670&717A60 4&7 21 
El23clDDlS4FC7DDT4BlB7a9A60 39 3E&0lE70lA60lEE01270 3 48 3&EOC4007 4270 2Afi0lA7A9 
El23El2DD2Êiefc£600AAer 4343007 4r Bf7a60 4b7 16BA8Q4 300 lDr6A47rr78 1B78 9A60 49 3 30 
El23cl4D74eeOl^firAA6D46B0 3690 44&rA9EEfi0 3a78A9EEE02 9EEfi0fi3 2 37A70 2Bia789A7aE 
El23Bl6DrBAlD32&D3$56c09 43000 3E6A4B7E7 430007EfiAA7Br7 4 30003EfiAA07r7 43000 9D3 
El23cieDF6AAD7F7&ESFD19E€E02 9EE60 2A0019ES70 2 2 40 39E«A0I9EEfi0 2A0ES9EEfi0lA2AO 
El23ElADD325E7F6A4FBF7BfiOc9 3E70fiB60DE707BfiO8E409 26rAB60CE70 4Bfi0DE007E70 3c0 
El23ElcDEe04fi2DeE7D4430007EfiA4c7E7 4300Q9E€AA07E79E6r019EfiF0 2 9EEfi0 2AOOÍ9EOC 
El23ElEOE7D224D39E6AD19EEfi0 2A0ES9EEfi0LA20 3 2 3E7EfiA4E3r7B60c9 3E70fi&60DE707 4O 
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Sl23E2DuB&DBE4D&2£rAfiS0c9EEr0 3G60o9EE70 49EE00fiB7 9r9 3E207 97B69ce006B7 9r9 303 

El23E220E205978SA06^EEl0 49rA200 9 3=;70 2E60 3A0 3lE60 2A2c3 2 30*6r0 26r0 3E60 3E0 9E 
s123e24DD3e£D2e2D425DCE60 3aOOIe70 3e60 4a200e70 2e60 3B7e60 2B7e60 3ee0 4CDE13b26 

e1d6h26da7dcí1e3 

Sl23E2e332D13DDlDDDDDQ0B700cQQQQQO0 10 10 2000 1090 2 20000 10 lOOcOOQO 90 4G000G2EE 
Sl23E2B3rrDlrrDD07D5Bl0 30B000A07C 30 20 3OB00OA0 403090 42B0 3 4D0O 4300 3400 200070 
£l23E2A3 45OO6cOO6SOOeBC07 4G07 2006rC06E00 6 9006&O0ScC061006 4G06 3006E00 2E0 30A 
S 123E2C355DD33DD420D3000 3BOO 2000 4 30076006 1006C007 3006 1007 40O69006eOO6e00AD 
Ell3E2E32DDD42DD&rDDei007 2006 4Q0E29 3s299E2clB8 
sl3 3rrrOEl22DrrrDrrrDrrrorrrDi 9corrrDc00 4c 
s9D3rrrrrE 
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Appendix D- Bill of Materials and Schematic 



This appendix Includes: 

- USB0BV1.01 Nl of materials — Table D-l 

• USB08 evaluation board schematic — Figure D-1 
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Table D- 1. Bill of Materials tot USB08 V 1.01 



Part 


Value 


CÍ.C2 


22 pF 


C3X4.C7.C9.C9.C10.C11.C12.C13.C14. 
C15.C17.C18.C19 


100 nF 


C5.C6 


IOuF 


cts 


100 uF 25 V 


C20.C21.C22 


10 nF 


D1.D2. D3. 04 


LED 


D5. OS 


BAT 42 


D7 


ZD8.2V 


D8 


1H4001 


IC1 


MC68HC908JB8ADW 


tC2 


MAX232A 


\C3 


7805 


JP1 


Header 2x8 


JP2 


Header 1-3 


L1.L2 


Ferríte 


Q1 


XTAL6MHZ 


Rt 


I.1PY7P iphowre sister) 


R2 


K164-47k tNTC| 


R3 


10 k <polenii<xne*er) 


R4 R5. RS 


10k 


R7 


1.5k/5%(op4onal) 


R8.R13. R14. R15 


10k 


R9 


22* 


RIO. RU. R12. R19 


330 R 


R1S R17 


27 R 


RT8 


10 M 


S1.S2. S3. S4. 85 


Push Button 


XI 


Header 2x13 


X2. X3 


Header 2x5 


X4 


Power Jack 
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Figure D-1. USB08 Evaluation Board Schematic 
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Appendix E. Universal USB Device Driver (USBIO) 



USBIO 

Universal USB Device Driver 

for Windows 98, Windows Millennium, 

and Windows 2000 



Reference Manual ^^^^^^^^^^^^^™ 

Version 1.41 IHCSYCOH 

2000 December 20 M»^iJ ».*-*#■* 

flf : Thu yet n" Sy item software & Consulting GmbH 
Weiilarer Plata l 
048693 llmenau 
Germany 

Telephone; +49 3677 .' a462-0 

Fa»; +49 3677/11462-18 

Email. USBIOiolthetyconde 

Web: http; Jvvww~theiyDDn.de 



Copyright C 1 1 998*2000 Tnesycon S ys lera soil wore and Consulting GmbH 
All Rights flese*ved 



Refimted vríty permission Irora fhesycun Syslem software A Consulting GmbH For kftlustonln 
ruo document, tie manual has been relc*mai-ed only. 

The 1 1 1 l v.ing tademarVs cue leleienced iiroughoul fltis manual: 
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trademarks ol Mitiusoll Corporator? . 
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holders. 
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Universal USB Device Driver (USBIO) 



E.1 Contents 



E,2 Iniioduction. 
E.3 Overview. . 
E.3,1 Platforms 
E.3.2 features . 

E.4 Archrtecture. 

E.4.1 U SBIO Object MoOel ,..,..,..,..,.. 

E.4.1.1 USB© Device Objects 

E.4.1.2 USBVO Pipe Objects ,..,..,..,.. 
E.4-.2 Establishing a Connection to the Device 

E.4.3 Power M anagement 

E.4. 4 Devce State Change Notifications . . , . . 



E,5 Programming Interface 

E.5. 1 Programming Interface Overview, . . , 
E.5,2 Control Requests ...,..,..,..,.., 

IOCTL_USBIO_GET_DESCRlPTOB. 

IOCTL_USBIO_SET_DESCRIPTOR. 

IOCTL_USBIO_SET_FEATURE 

IOCTL_USBIO_CLEAR_FEATURE. . 
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E.2 Introduction 



E.3 Overview 



USBIO is a generic Universal Serial Bus (USB) device driverlor 
Windows 98. Windows Millennium (ME), and Windows 2000. It is able to 
control any type of USBdevce and provides a convenient programming 
interface that can be used by Win32 applications. 

This document describes the architecture, the features, and the 
programming interface of the USBIO device driver Furthermore it 
includes instructions for installing and using the device driver 

The reader of this document is assumed to be familiar with the 
specification of the Universal Serial Bus and with common aspects of 
Win32-based applcation programming. 



Support for the Universal Serial Bus (USB) is built into the Windows 98. 
Windows Millennium, and Windows 2000 operating systems. These 
systems include device drivers forthe USB Host Controller hardware, for 
USB Hubs, and for some classes of USB devices. The USB device 
drivers provided by Microsoft support devices that conform with the 
appropriate USB device class definitions made by the USB 
Implemented Forum. USB devices that do not conform lo one of the 
USB device class specifications, e.g. in the case of a new devce class 
or a device under development, are not supported by device drivers 
included with the operating system. 

In order to use devices that are not supported by the operating system 
itself the vendor of such a device is required to develop an USB device 
driver. This driver has to conform to the Win32 Driver Model (WDM) that 
defines a common driver architecture for Windows 98, Windows 
Millennium, and Windows 2000. Writing, debugging, and testing of sixh 
adriver means considerable effort and requires a lot of knowledge about 
development of kernel mode drivers. 

By using the generic USB device driver USBIO it is possible to get any 
USB device up and running without spending the time and the efforl of 
developing a devce driver. Especially, this might be useful during 
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development or test of a new device. But in many cases ills a!so suitable 
to include the USBIOdevce driver in the final product. So there is no 
need to develop and test a custom device driver for the U SB-based 
product at all. 



E.3.1 Platforms 



The USBIO driver supports the following operating system platforms: 
Windows 98 (Gold), the first release of Windows 98 

Windows 98 Second Edition (SE), the second release of 
Windows 98 

Windows Millennium, the successor to Windows 98 

Windows 2000, the successor to Windows NT 

Windows 2000 Service Pack 1 

NO TE: Windows NT 4.0 and Windows 95 are not supported by USBIO. 



E32 Features 



The USBIO driver provides the following features: 

• Compiles with the Win32 Driver Model (WDM) 

• Supports Plug&Play 

• Supports Power Management 

• Provides an interface to USB devices that can be used by any 
Win32 application 

• Provides an interface to USB endpoints (pipes} that is similar to 
files 

• Fully supports asynchronous (overlapped) data transfer 
operations 

• Supports the US8 transfer types Control, Interrupt. Bulk, and 
Isochronous 
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* Multiple USB devices can be controlled by USBIO at the same 
time 

* Multiple applications can use USBIO at the same time 

The US8IO device driver can be used to control any USB device from a 
Win32 application running in user mode. Examptes ot such devices are 

* telephone and tax devices 

* telephone network switches 

* audio and video devices (e.g. cameras) 

* measuring devices (e.g. oscilloscopes, logic analyzers) 

* sensors (e.g, temperature, pressure) 

* data converters (e.g. A/'D converters. D/A converters) 

* bus converters or adapters (e.g. RS 232. IEEE 488) 

* chip card devces 

If a particular kernel mode interface (e.g. WDM Kernel Mode Streaming, 
NDIS) has to be supported in order to integrate the device into the 
operating system, it is not possible to use the generic USBIO driver. 
However, in sixh a case it is possible to devefop acustom device driver 
based on the source code of the USBIO though. Please contact 
Thesycon if you need support on such kind of project 

Although the USBIO device driver fully supports isochronous data pipes, 
there are some limitations with respect to isochronous data transfers. 
They result from the tact that the processing ot the isochronous data 
streams has to be performed by the application wheh runs in user mode. 
There is no guaranteed response time tor threads running in user mode. 
This may be critical tor the implementation of some synchronization 
methods, for example when the data rate is controlled by foop-back 
packets (see the USB Specif catton. Chapter 5 tor synchronization 
issues of isochronous data streams). 

However, it is possible to support all kinds of isochronous data streams 
using the USBIO driver But the delays that might be caused by the 
thread scheduler of the operating system should be taken into 
consideration. 
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E.4 Architecture 



Figure E-1 shows Ihe USB driver slack thai is part ot the Windows 98, 
Windows Millennium, and Windows 2000 operating systems All drivers 
embedded within Ihe WDM layered architecture. 



Usei Mod» 
Kernel Mode 



Win32 Application 



USBIO. SYS 




USB Driver Interlace <US8DI 



USBO 5\5 



USBHUB.SY5 



OpenHCISYS 



Hardware 



USB HoilConroller 



Figure E-1. USB Driver Stack 

The following modules are shown in Figure E-1: 

■ USB Host Controller is Ihe hardware component thai controls Ihe 
Universal Serial Bus. It also contains xfte USB Root Hub. 

• OpenHCLSYS is lhe host controller driver lor controllers that 
conform wrth the Open Host Controller Interface specification. 
Optionally, it can be replaced by UHCD SYS thai is the Universal 
Host Controller Driver. Which driver is used ctepends on the 
main-board chip set lor the PC. For instance. Intel chipsels 
contain an Universal Host Controller. 
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• USBD.SYS is the USB Bus Driver that controls and manages all 
devices connected to the USB. It is provided by Microsoft as part 
of the operating system, 

• USBHUB.SYS is the USB Hub Driver It is responsible tor 
managing and controlling USB Hubs, 

• USBIOSYS is the generic USB device driver USBIO, 

The software interface that is provided by the operating system for use 
by USB device drivers is called USB Driver Interface (USBDI). It is 
exported by the USBD at the top of the driver stack. USBDI is an 
IRP-based interface. This means that each individual request is 
packaged into an I/O request packet (IRP). a data structure that is 
defined by WDM. The I/O request packets are passed to the next driver 
in the stack for processing and returned to the caller after completion. 

The USB Driver Interface is accessible for kernel mode drivers only. 
Normally, there is no way to use this interface directly from applicatbns 
that run in user mode. The USBIO device driver was designed to 
overcome this limitation. It connects to the USBDI at its lower edge and 
provides a private interface at its upperedge that can be used by Win32 
applications. Thus, the USB driver stack becomes accessible to 
applications, A Win32 application is able to communicate with one or 
more USB devices by using the programming interface exported by the 
USBIO device driver. Furthermore, the USBIO programming interface 
may be used by more than one application or by multiple instances of 
one application at the same time. 

The main design 93a! for the USBIO device driver was to make available 
to applcatbns all the features that the USB driver stack provides at the 
USBDI level For that reason the programming interface of the USBIO 
device driver (USBIOI) is closely related to the USBDI, But many of the 
functions cannot be translated in an one-to-one relationship. 



USB08 Evaluaton Board Designer Reference Manual 

MOTOROLA Uriversal USB Device Driver (USBO) 139 



Universal USB Device Driver (USBIO) 



E.4,1 USBIO Object Model 



The U SBIO device driver provides acommunication model that consists 
ol devkse objects and pipe objects. The objects are created, destroyed, 
and managed by the USBIO driver An application can open handles to 
device objects and bind these handles to pipe objects. 

EA.1.1 USBIO Device Objects 

Each USBIO device object is associated withaphyscalUSBdevce that 
is connected to the USB. A device object is created by the USBIO driver 
in response to an Add Device request from the Plug&Play Manager of 
the operating system. The USBIO driver is able to handle multiple device 
objects at the same time. 

Each device object created by USBIO is registered with the operating 
system by using a unique identifier (GUID. Globally Unique Identifier). 
This identifier is called* Device Interface ID*. All device objects managed 
by USBIO are identified by the same GUID.The GUID is defined in the 
USBIO Setup Information (INF} file. Based on the GUID and an instance 
number, the operating system generates a unique name forea:h device 
object. This name should be considered as opaque by applications. It 
should never be used directly or stored permanently. 

It is possible to enumerate all the device objects associated with a 
particular GUID by using functions provided by the Windows Setup API. 
The Functions used for this purpose are: 
SctupDiGetClassDcvs ( ) 
SctupDiEnumDcv ice Interfaces ( ) 
SetupDiGetDevicelnterfaceDetailO 

The result of the enumeratbn process is a list of devce objects currently 
created by USBIO. Eashof the USBIO device objects corresponds to a 
device currently connected to the USB. For each device object an 
opaque device name string is returned. This string can be passed to 
CreateFile { ) to open the device object. 

A default Device Interface ID (GUID) is built into the USBIO driver This 
default ID is defined in USBIOJ.H. Each device object created by 
USBIO is registered by using this default ID. The default Device 
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IMPORTANT: 



NOTE: 



Interface ID is used by the US8IOdemo application for ctevice 
enumeration. This way, it is always possible to access devices 
connected to the USBIO Irom the demo application. 

In addition, an user-defined Device Interface ID is supported by USBIO. 
This user-defined GUID is specified in the USBIO INF file by the 
USBIO_UserInterfaceGuid variable. If the user-defined interface ID 
is present at device initialization time USBIO registers the device with 
this ID. Thus, two interfaces — default and user-defined — are 
registered for each device. The ctefault Device Interlace ID should only 
be used by the USBIO demo application. Custom applications should 
always use a private user-defined Device Interface ID. This way, device 
naming conflicts are avoided. 

Every USBIO customer shoufcJ generate its own private device interface 
GUID. This is done by using the tool GUIDGEN.EXE from the Microsoft 
Platform SDK or the VC++ package. This private GUID is specified as 
user-defined interface in USBIO_UserInterf aceGuid in the USBIO 
INF file. The private GUID is also used by the customer's application for 
device enumeration. For that reason the generated GUID must aJso be 
included in the application. The macro DEFINE_GUID() can be used for 
that purpose. See the Mcrosoft Platform SDK documentation for further 
information. 

As stated above, all devices connected to USBIO will be associated with 
the same device interface ID that is also used for device object 
enumeration. Because of that, the enumeration process will return a list 
of all USBIO device objects. In order to differentiate the devices an 
application should query the device descriptor or string descriptors. This 
way, each device instance can be identified unambiguously. 

After the application has received one or more handles for the device, 
operations can be performed on the devce by using a handle. If there is 
more than one handle to the same device, it makes no difference which 
handle is used to perform a certain operation. All handles that are 
associated with the same device behave the same way. 

Former versions of USBIO (up to V1. 16) used a different device naming 
scheme. The device name was generated by appending an Instance 
number to a common prefix. So the device names were static, in order 
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to ensure compatibility USBIO still supports the old naming scheme. 
This feature con be enabled by defining a device name prefix in the 
variable OSBIO_Devi ceBa a&Name in the USBIO INF file. However, it is 
strongly recommended to use the new naming scheme based on Device 
Interface IDs (GUID&h because it conforms with current Windows 2000 
guidelines. The old-style static names should only be used if 
backward-compatibility wãh former versions of USBIO is required. 



E.4J.2 USBIO Pipe Objects 



The USBIO driver uses pipeob)3cls lo represent an active endpoint of 
the device. The pipe obpcts are crated when the deice configuration is 
set The number and type of created pipe objecis depend on the 
selected configuration. The USBIO driver does not control the default 
endpoint (endpoint zero) of a device. This endpoint is owned by the USB 
bus driver USBD + Because of that, there is no pipe object for endpoint 
2eio and there are no pipe objects available until the devce is 
configured. 

In order to access a pipe the application has to create a handte by 
opening the device object as described above and attach it to a pipe. 
This operation is called"bind*. Alter a binding is successfully established 
the application can use the handle to communicate with the endpoint 
that lhe pipeobjecl reptesents. Each pipe maybe bound only once, and 
a handle may be bound to one pipe only. So there is always an 
one-to-one relation of pipe handes and pipe objects* This means that 
the application has to create a separate handle for each pipe It wants to 
access* 

The USBIO driver also supports an "unbind* operation. That is used to 
delete a binding between a handle and a pipe. After an unbind is 
performed lhe handle may be reused to bind anolher pipe object and the 
pipe object can be used to establish a binding with another handle. 

The following example Is intended to explain the relationships described 
above. In Figure E-2 a configuration is shown where one device object 
and two associated pipe objects exist within the USBIO data base. 
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Figure E-2, USBIO Oevice and Pipe Objects Example 

The device object is Identified by a device name as described in 
E.4.1.1 USBIO Oevice Objects. A pipe object is identified by its 
endpoinl address that also includes the direction flog at bit 7 (MSB) Pipe 
0x81 is an IN pipe (transfer direction from device to host) and pipe 0x02 
is on OUT pipe {transfer direction from host to device). The application 
has created three handles for the device by calling Great eFile{). 

Handlel is not bound to any pipe, therefore it can be used to perform 
device-related operations only. It is called a device handle. 

Handle2 is bound to the IN pipe 0x81. By using this handle with the 
Win32 function ReadFile() the application can initiate data transfers 
from endpoinl 0x81 to its buffers. 

Hand(e3 is bound to the OUT pipe 0x02. By using Handles with lhe 
function Wr it eFile<) the application can initiate data transfers from its 
buffers to endpoinl 0x02 of the device. 
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Handle2 and Handte3 are called pipe handles. Note that while Handlel 
cannot be used to communicate with a pipe, any operation on the device 
can be executed by using Handle2or Handle3, too. 



E.4.2 Establishing a Connection to the Device 



The foltowing code sample demonstrates the steps that are necessary 
at the USBIO API to establish a handle for adevce and a pipe. The code 
is not complete, no error handling is included. 



if include the interface headec rile or rjRVTD-ff¥S 
hncludr *u*tile_l . n" 

// device tiuunrr nunbcr 

'del ine DCVIC£_8tUKB&tt -3 

.'/ lone locd! vittftb; ?.* 

HArírLK Fll eMandl e; 

USrllO.Ser.COHrKIUfUkrEOM SelCenllqurdllen; 

t-^aiO^Ot HD_n PB Bi r.irijiEj 

rtDBVlttrO Devi nra; 

QUID 9_Uvbi of D * USBEQ_11D; 

SF_DKV1 "t^: HrEM p ACE_GArA OcvDdCa; 

sr_i Hrer*rA^B_DEVicB_DBrAi l_data 'Ocvrei* 1 i * null; 

DHOnQ IteqLen; 

MÍJM3 By t -a Ret umed; 

// cnuneratc trie device» 

.*',' u-t « handle 14 the device List 

Icvlnro - Set npQi^dClditDcvi )la_tJ*i>i DlD r 

HULL. HULL, Or OCPJÍCVI rBl HTBftfACEl OI OCf^rMCSEHr J ; 
// gee the device with index t>BVlTB_»UMriKn 
Set tjpDtBnuiiDevtceEnt err Acer I Devi nra, HULL, 

I j_u»t>i tio, r>E\*icE_wu«iien, i Devo at i 1 í 

fj get length of iPUiIcd itiicrM'.nn 

Set upDl aetDevicilr.t -rn f-On e:! (Sevlnro. iscvcat ft, HULL, 

3, ifteqLen, HULL) ; 

♦V allocate a buffer 

PevtP 411 ■ (5r j _lHTBr\rACB_D£Vl-?B_DBrAE L^trATA* I nillec IRcqtcn} : 

// nav id trie detailed device t nr or rut l an 

rev ret all-'CbStxe - «txeor |Sr_rHrBRrACB_DBVrCB_OBrAJ L_DAtAi ; 

Set upDl Det Devi eel nter ra ccSet ai l (Ocvlní o, CDevDat a, DevDeta i i , 

IteqLcn, tneqLen, HULL) ; 

// open the device, uare DVERLAF fBD rlacj It ne?ciiAiv 

// use DevQet ai ; - -revi 7ct it h aa device nine 

TiLeMandle * rrcatetftlel 

DevDet ell *>Devlcerat h, 

IBHBBI ^_MB AQ i OBHBB1 -_M?M TC, 

rt t£_PrtAPS_Wr<l TBI ri Le_SrlAnE_ftttAEJ, 

na LL. r 

or CH_tx i s r i wd, 

O y • oe FI LE_FLA<l_OVBfM-AfrBtJ • i, 
HULL) ; 
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// setup tne 44t a vt cuclure fee cflnriquntl on 
// use tne cotid^urj%ior> dcicriptor slth index O 
ífí ton r i gurdt inn . CcnilQurti i ont ndrx - O; 
'■ tlevl?e ndx J inlccltrv 
rsir,ir.ft gurdtion. ate cnt-ffa ecu ■ i ; 
// IlVBfe intcrticc !■ O 

i«C«nf tourdtlQn.lnt etraetU Bt(D| .Inleif icelndcx * O; 
//' fll' *;t.^ setting Tar rtril interface is D 

Set Can f t gucdt ion. I W err^cpti pi [ c ' I .^Urtftti eSet t i r. gt no) ex ■ 3; 
' ' ndHinun luji*: me for icdd/xclt c cprrdT j tin ;■ 4DA£ byte* 
SctCanrLQUCdt ion. tnt erra ceList(D| .KdKi nuBTniufuBi xe v 4d^f * 

// ror.u ijutc tne jevt ce 
Levi eel iC^nt rot |r i 1 erJamll e, 

t ccrL_us»i &_fftcr_ccnr : aun*rt au, 

C Set Cenf l^uctticn, al sceee | Set C en ft mriltrn), 

HULL r O, 

k^jyt E'^ctutncd, 

HULL 

J ; 

// setup tne ddtd ttcueture to bind the file hsndl? 

p ; nrir i p p. tfntlpcinl A4dt»e ■ CxflL; {/ tne Jevice in= an cndpolnt *ixf>l 

imd tne file nandle 
Levi eel iCinltol |ri 1 erlandle, 

TOCr L_U50XD_sf »l>__ri Ft 

(Dindrtpe, sleeef iBi ndfxpel , 

KULL.D, 

^v etneturned, 

HULL 

i rj a) foe *nte| dttd Fron it o| the OcvJcr 
// use 'JVCrLArfn. structure if n7?c»diy 

t\e* dP; iFiri l?nandLe, . • . i ; 

// rlaic file hindle 
Clanertandl e (If i J rUtiidl e| ; 



Refer to the Win32 API documentation lor the syntax and the 
parameters of the functions SetupDiXxx. CreateFile, 
DeviceXoControl, ReadFile, WriteFile. CloseHandle. The file 
handle can be opened with the FILB_FI*AG_0VBRLAPPED flag if 
asynchronous behavbur is required. 

More code samples that show the usage of the USBIO programming 
interface can be found in the USBIO Class Library {USBJOLIB), the 
USBIO demo applcation (USBIOAPP), and the simple console 
applications ReaderCpp and ReadPipe, 
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E.4.3 Power Management 



Windows 96. Windows Millennium, and Windows 2000 support system 
power management. Thai means lhat i( the computer is idle for a given 
time, some parts of the compulercan go into a steeping mode, A system 
powerchange can be initiated by the useror by the operating system 
itself, on a tow battery condition tor example. An USB tfevtce driver has 
to support the system power management Each device which supports 
power swrtching has to have a device power polCy owner. It is 
responsible [or managing ths device power slates in response lo system 
power stale changes. The USBIO driver is the power policy owner of the 
USB devices thai it controls. In addition to the system powerchanges the 
device power policy owner can initiate device power state changes. 

Before the system goes into a sleep state the operating system asks 
every driver it its device can go into the sleep state. If all active drivers 
return success the syslem goes down. Otherwise, a message box 
appears on tl"e screen and informs the user that the system is not able 
to go into the steeping mode. 

Before the system goes into a sleeping state the driver has to save all 
the information that it needs to reinitialize the device (device context) if 
the system is resumed. Furthermore, all pending requests have to be 
completed and further requests have to be queued. In the device power 
states D1 or D2 (USB Suspend) the device context stored in the USB 
device will be lost Therefore, a device steeping state Di or D2 is 
handled transparent for the application. In the state D3 (USB Off) the 
device context is lost. Because the information stored in the device is 
known to the application only (e<g. the current volume level of an audio 
device), the generic USBIO driver cannot restore the device context in a 
general way. This has to be done by the application. Note that Windows 
2000 restores the USB configuration of the device 
(SET_CONFIGURATION request) after the system is resumed. 

The behavOurwKh respect to power management can be customized by 
registry parameters. For example, if a bng time measurement should be 
performed the computer has to be prevented from going power down. 
For a description of the supported registry parameters, see E.9 Registry 
Entries 
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All registry entries describing device power states are DWORD 
parameters where the value corresponds to DevicePowerDO, 1 to 
DevicePowerDl. and so on. 

The parameter PowerSt at eOnOpen specifies the power state to which 
the device is set if the first fite handle is opened. It the last file handle is 
closed the USB device is set to the power state specified in the entry 
PowerSt at eOnClose, 

If at least one file handle is open for the device the key 
MinPowerStateUsed describes the minimal device power state that is 
required. If the value is set to the computer will never go into a sleep 
state. If this key is set to 2 the device can go into a suspend state but not 
into D3 (Oft). A power-ctown request caused by a low battery condrt ion 
cannot be suppressed by using this parameter. 

If no file handle is currently open (or the devce. the key 
MinPower St at eUnused defines the minimal power state the devce 
can go into. Thus, its meaning is similar to that of the parameter 
MinPowerStateUsed. 

If the parameter AbortPipesOnPowerDown is set to 1 all pending 
requests submitted by the application are returned before the device 
enters a steeping state. This switch should be set to 1 if the parameter 
MinPowerStateUsed is different from DO. The pending I/O requests 
are returned with the error code USBlO_ERR_POWER_DOWR This 
signals to the applcation that the error was caused by a power down 
event. The application may ignore this error and repeat the request. The 
re-submitted requests will be queued by the US8IO driver. They will be 
executed after the devce is back in state DO. 
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E.4.4 Device State Change Notifications 



NOTE. 



The application is able to receive notifications when the state of an USB 
device changes. The Win32 API provides lhe function 
RegisterDeviceNotif ication (or this purpose* This way, an 
application will be notified if an USB device is plugged in or removed. 

Please reler to the Microsoft Platform SDK documentation for detailed 
information on the functions RegisterDeviceNotif ication and 
UnregisteredDeviceNotif ication. In addition, the source code 
of lhe USBIO demo application USBIOAPP provides an usage example. 

Thedevce notifcation mechanism is only available If the USBIO ctevce 
naming scheme is based on Device Interface IDs (GUIDs). See 
E.4.1.1 USBIO Device Objects fordetails. We strongly recommend to 
use this new naming scheme. 

The function UnreglsteredDevlceNotif ication should not be 
used on Windows 98. There is a bug in the implementation that causes 
the system to become unstable. So it may crash at some later point in 
time. The bugseems to be well known", it was discussed in some 
Usenet groups. 
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E.5 Programming Interlace 



ESA Programming Interlace Overview 



Table E-1, LO Operations Supported by the USBIO Device Driver 



Operation 


U ted On 


Bus Action 




K>CTL_USBK)_GETJ)RIVERJNFO 


device 


_ 




K>CTL_USBK>_GET_DESCRiPTOR 


device 


request on detauli ripe 




IOCTL_USBIO_SET_DESCRlPTOR 


device 


request on default pipe 




IOCTL_USBIO_SET_FEATURE 


device 


request on default pipe 




IOCTL_USBIO_CLEAR_FEATURE 


device 


request on detault pipe 




I0CTL_USBK)J3ET_STATUS 


device 


request on detault pipe 




IOCTL_USBK>_GET_CONFIGURAT10N 


device 


request on default pipe 




I0CTL_USBI0J3ET_INTERFACE 


device 


request on detault pipe 




K>CTL_USBIO_STORE_CONFIG_DESCRIPTOR 


device 


— 




IOCTL_USBK>_SET_CON FIGURATION 


device 


reediest on detauli pipe 




IOCTL_USBIO_UNCONFIGUREJ>EVICE 


device 


request on detault pape 




K)CTL_USBIO_SETJNTERFACE 


device 


request on detault pipe 




IOCTL USBIO CLASS OR VENDOR IN REQUEST 


device 


reifjest on detault pape 




IOCTL_USBIO_CLASS_OR_VENDOR_OUT_REGUEST 


device 


request on detauli pipe 




K>CTL_USBIO_GET_DEVICE_PARAMETERS 


device 


— 




IOCTL_USBIO_SET_DEVICE_PARAMETERS 


device 


— 




IOCTL_USBIO_GET_CONFIGURATIONJNFO 


device 


— 




K>CTL_USBI0_RESETJ3EVICE 


device 


reset on hub port USBD 
assigns USB add* ess 




©CTL_USBIO_GET_CURRENT_FRAME_NUMBER 


device 


— 




IOCTLJJSBIO_GET_DEVICE_POWER_STATE 


device 


— 




K>CTL_USBK)_SETJ>EVICE_POWER_STATE 


device 


set properties on hub port 




IOCTL USBIO BIND PIPE 


device 


^ ^—^—^^^~ 




IOCTL_USBIOJJNBIND_PIPE 


pipe 1 — 




K)CTL_USBIO_RESET_PIPE 


pipe request on default pipe 




IOCTt_USBIO_ABORTJ>IPE 


Dip* 


— 




K>CTLJJSBIO_GETJ>IPE_PARAMETERS 


pipe 


— 




K>CTL_USBK)_SETJ>IPE_PARAMETERS 


Sip* 


— 




K>CTL_USBK>_PIPE_CONTROL_TRANSFERJN 


Dip* 


request on pipe 




IOCTL_USBIOJ>IPE_CONTROL_TRANSFER_OUT 


pipe ' reqjest on pipe 




Read File 


Pipe 


data iransler Irom pipe (IN) 




Write File 


Cip* 


data iransler to pipe (OUT) 
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E.55 Control Requests 



This section provides a detailed description of the I/O Control operations 
the USBIO driver supports through its programming interface. The I/O 
Control requests are submitted to the driver using the Win32 function 
DeviceloControl (see E.4 Architecture) The DeviceloControl 
(unction is defined as follows 



boat» Oir*i.-rl»t<r»L tcl I 
rtAftT)L> hPiVtc?, 

DfcTOftb 4vI#f4Pt I4l CC*lC f 

ITV^it tpf nOuf Ifer r 
PITCH p flihSi,itT:;:(-, 
l-rvi>;& IpPutfiuf Cci, 



i-f -VfMArrCQ ipfl*e 



< ? 



. . , , 



' / rant ccl ccdr &Í >pc 

I pojnfecr U utiUef V 

/* *ir- c: IntfUt «otic 

/ »i7- Cf aulpiit tuíf 

l : K/ » *-* VííUblC 

' f cut cm [7TC count 



rati on 



t#t 
Lire cot 1 



* : ;:r:i'it 



US dfct I 



d st ci 

CI At 1 £t 



Refer to the Microsoft Pl3tform SDK documentation for more 
Information. 

The following sections descnbe the I/O Control codes that may be 
passed to the DeviceloControl funclbnasdwIoControlCode and 
the parameters required for IpInBuf fer. nlnBuf f erSize. 
lpOutBuf f er. nOutBuf f erSize 
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IOCTL USBIO GET DESCRIPTOR 



lpInBuf fer 

nlnBufferSixe 

lpOut Buffer 

nOut Buffer Size 

Comments 



The IOCTL_USBIO_GET_DESCRIPTOR operation requests a specific 
descriptor Irom the device* 

Pointer to a buffer thai contains an USBK>_DESC RIPTOR_REOUEST 
(page 187) data structure. This data structure has to be filled completei/ 
by the caller- 
Specifies the size, in bytes, of the buffer point to by lpInBuf f er. which 
has to be sizeol(USBIOJDESCRIPTOR_REQUEST) tor this operation. 

Pointer to a buffer that will receive the descriptor data. 

Specifies the size in bytes, of the buffer pointed to be ipOutBuf f er 

The bulfer that is passed to this function in IpOutBuf f er should be 
large enough to hold the fequested descriptor, otherwise only a part of 
the descriptor will be returned. The size of the output buffer should be a 
multiple of the packet size of the default pipe (endpoint zero). 
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IOCTL USBIO SET DESCRIPTOR 



lpInBuf fer 



nlnEuf ferSize 



lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTL_USBIO_SET_DESCRIPTOR operation sets a specific 
descriptor of the device. 

Pointer to a buffer that contains an USBtO_DESC RIPTOR_REQUEST 
(page 187) data structure. This data structure has to be filled completely 
by the caller 

Specifies the size, in bytes, ol the buffer pointed to by lpInBuf f er. 
which has to be sizeof(USBIO_DESCRIPTOR_REQUEST) for this 
operation. 

Pointer to a buffer that contains the descriptor data to be set_ 

Specifies the size. In bytes, ol the butfer pointed to by lpOutBuf f er 

USB devices do not have to support this operation 
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IOCTL USBK> SET FEATURE 



lpInBuf fer 



nlnBuf ferSize 



lpOut Buffer 

nOutBuff erSize 

Com/nenta 



The IOCTL_U SB IO_SET_FE ATURE operation is used lo setorenabfc 
a specific feature. 

Pointer lo a buffer that contains an USBIO_FEATURE_REGUEST 
(page 188) data structure. This data structure has to be filled completely 
by the caller 

Specifies the size, in bytes, of the buffer pointed to by lpInBuf f er. 
which has to be sizeof(USB10_FEATURE_REQUE3T) for this 
operation 

Not used with this operation Sel to NULL. 

Not used with this operation. Set to zero. 

The SET_FEATURE request appears on the bus with the parameters 
specified in the IOCTL_USBIO_SET_FEATURE structure. 
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IOCTL USBIO CLEAR FEATURE 



lpInBuf fer 



nlnBufierSne 



lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTL_USBIO_CLEAR_FEATURE operation is used to clear or 
disable a specific feature. 

Pointer to a buffer that contains an USBtO_FEATURE_REQUEST 
(page 188) data structure. This data structure has to be filled completely 
by the caller 

Specifies the size, in bytes, ol the buffer pointed to by lpInBuf f er. 
which has to be sizeof(USB10_FEATURE_REQUE3T) for this 
operation. 

Not used with this operation Set to NULL. 

Not used with this operation. Set to zero. 

The CLEAP_FEATURE request appears on the bus with the parameters 
specified in the IOCTL_USBIO_CLEAR_FEATURE stricture. 
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IOCTL USBIO GET STATUS 



lpInBuf fer 



The IOCTL_USBIO_GET_STATUS operation requests status tor a 
specific recipient. 

Pointer to a buffer that contains an USBtO_STATUS_REQUEST 
(page 189) data structure. This data structure has to be filled completely 
by the caller 



nlnBufferSixe Specifies the size. In bytes, of the buffer pointed to by lpInBuf £ er. 



lpOut Buffer 



nOutBuf £ erSrze 



Comments 



which has to be sizeot(USBIO_STATUS_REOUEST) for this operation. 

Pointer to a buffer that will receive an 
USBIO_STATUS_REQUEST_DATA (page 190) data structure. 

Specifies the size, in bytes, ol the butfer pointed to by IpOutButfer. 
Which has to be at least sizeof(USBlO_STATUS_REQUEST_DATA) for 
this operation. 

The GET_STATUS requesr appears on the bus with the parameters 
specified in the USBIO_STATUS_REOUEST (page 1 69) structure The 
function returns the structure USB1O_STATUS_REQUEST_0ATA 
(page 1 90) whch contains two bytes of data. 
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IOCTL USBIO GET CONFIGURATION 



lpInBuf fer 

nlnBufferSize 

lpOut Buffer 

nOut Buffer Size 



Comments 



The IOCTL_USBIO_GET_CONRGU RATION operation returns the 
current configuration ot the device. 

Not used with this operation. Sei lo NULL. 

Not used with this operation. Sei to zero. 

Pointer lo a buffer that will receive an 
USBIO_GET_CONFIGURATION_DATA (page 191) data structure. 

Specifies the size, in bytes, ol the bulfer pointed to by lpOutBuf f er. 
which has to be at leaât 5izeofiUSBIO_GET_CONFIGURATlON_DATA) 
for this operation. 

A GET_CONFIGU RATION request appears on the bus. The structure 
USBIO_GET_CONFIGURATION_DATA (page 191) returns the 
configuration value. A value ol zero means "not configured'. 
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IOCTL USEIO GET INTERFACE 



lpInBuf fer 



The IOCTL_USBIO_GET_INTERFACE operation returns the current 
alternate setting of a specific interface. 

Pointer to a buffer that contains an USB tO_GET_INTER FACE 

(page 192) data structure. This data structure has to be filled completely 

by lhe caller 



nlnBuff erSixe Specifies the size. In bytes, ol the buffer pointed to by lpInBuf £er. 

which has to be sizeot(USBiO_GETJNTERFACE) tor this operation 



lpOut Buffer 



nOutBuf £ erSrze 



Comments 



Pointer to a buffer that will receive an 
USBIO_GETJNTERFACE_DATA (page 193) data structure 

Specifies the size. In bytes, ol the buffer pointed to by lpOutBuf fer. 
which has to be at least 5izeof(USBIO_GETJNTERFACE_DATA) for 
this operation, 

A GETJNTERFACE request appears on the bus The structure 
US8IO_GETJNTERFACE_DATA (page 193) returns lhe cunent 
alternate setting of the interface specified In USBIO_GETJNTERFACE. 
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IOCTL USBIO STORE CONFIG DESCRIPTOR 



lpXnBuffer 

nlnBuff erSize 

lpOut Buffer 

nOut Buffer Size 



The 10CTL_USBIO_STOBE_CONFIG_DESCBIPTOR operation stores 
lhe conlíguraton descriptor to be used for set configuration requests 
within the USBIO device driver 

Pointer (o a buffer that contains the configuration descriptor data 

Specifies the size. In bytes, ol the buffer pointed to by IpInBuf f er. 

Noi used with this operation. Set to NULL. 

Not used with this operation. Set to zero 



Comments This request may be used to store an user-defined configuration 

descriptor within the USBIO driver The stored descriptor Is used by the 
USBIO driver in subsequent IOCTL_USBIO_SET_CONFIGURATION 
(page 1 59) operations. The usage of 

IOCTL_USBIO_STORE_GONFIG_DESCR!PTOR is optional. II no 
user-defined configuration descriptor is stored, USBIO uses the 
descriptor from the device. 

There may be cases where the USBD driver provided by Microsoft with 
Windows does not process correctly the configuration descriptor that is 
reported by the device. This means it would not be possible to conligure 
the device. In this situation the 

IOCTL_OSBIO_STORE_CONFIG_DESCRIPTOR request may be used to 
work around the problem. This request enables the application to use a 
modified configuration descriptor The application can get the 
configuration descriptor using ISOCTL_USBIO_GET_DESCRIPTOR 
(page 151). modify it appropriately and store it in the USBIO driver using 
the ioctl_U5BIO_store_config_de5CRIPTOR request. Thus, the 
modified configuration descriptor will be passed to USBD when the 
device is configured. 

The foltowing is an example for the problem descnbed above: 

In the endpoint descriptor of an audio device the bmAt tributes 

field contains two additional bits ol Information as defined by the 
audio class specification. The USBD does not recognize the pipe 
correctly and returns an invalid pipe type, when the additional bits 
InbmAttributes are not masked off. This has lo be done by the 
application. 
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IOCTL USBIQ SET CONFIGURATION 



lpInBuf fer 



nlnBuff erSiae 



The IOCTLJJSBIO_SET_CONFIGURATION operation is used to set 
the device configuration. 

Pointer lo a buffer that contains an USBtO_SET_CONFIGURAT!ON 
(page 195) data structure. This data structure has to be filled completely 
by the caller 

Specifies the size, in bytes, of the buffer pointed to by lplnBuf £ er. 
which has to be sizeot(USBIO_SET_CONFIGURATION) for this 
operation. 



lpOutBuf f er Not used with this operation Set to NULL. 
nOutBuf f erSize Not used with this operation. Set to zero. 

Comments A SET_CONFIGU RATION request appears on the bus. The USBD 
generates additional SET_INTERFACE requests on the bus if 
necessary. 

All available interfaces have lo be configured, or the request will fail* The 
numberof interfaces and the alternate setting tor each interface have to 
be specitied in the structure USBIO_SET_CONFIGURATION 
(page 195). 

All pipe handles associated with the device will be unbound and all 
pending requests will be cancelled. If this request returns with success, 
new pipe objects are available. The operation 
IOCTL_USBtO_GET_CONFIGURATIONJNFO (page 166) may be 
used to query all available pipes and interfaces. 

By default, the configuration descriptor that is reported by the device is 
passed to the USBD. It an user-defined configuration descriptor is stored 
with IOCTL_USBIO_STORE_CONFIG_DESCRIPTOR (page 158). this 
descriptor is used. 
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IOCTL USBIO UNCONFIGURE DEVICE 



lpInBuffer 

nlnBuf ferSize 

lpOut Buffer 

nOut Buffer Size 



The IOCTL_USBIO_UNCONFIGURE_DEVICE operation is used lo set 
the device to its unconfigured state. 

Not used with this operation. Set to NULL, 

Not used with this operation. Set to zero. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 



Comments A SET_CONFIGURATlON request with the configuration value 

appears on the bus. All pipe handles associated with the device will be 
unbound and all pending requests will be cancelled. 
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IOCTL USBIO SET INTERFACE 



lpInBuf fer 



nlnBufferSne 



lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTLJJSBIO_SETJNTERFACE operation sets the alternate 
setting of a specific interface. 

Pointer to a buffer that contains an USBtOJNTERFACEjSETTING 
(page 194) data structure. This data structure has to be filled completely 
by the caller 

Specifies the size, in bytes, of the buffer pointed to by lpInBuf f er. 
which has to be sizeot(USBIOJNTEHFACE_SETTING) for this 
operation 

Not used with this operation Sel to NULL. 

Not used with this operation. Set to zero. 

A SETJNTEBFACE request appears on the bus. 

All pipe handles associated with the Interlace will be unbound and all 
pending requests will be cancelled If this request returns with success, 
new pipe objects are available. The operation 
IOCTL_USBIO_GET_CONFIGUFiATlONJNFO (page 166) may be 
used lo query all available pipes and interfaces. 
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IOCTL USBIO CLASS OR VENDOR IN REQUEST 



The IOCTL_USBIO_CLASS_OR_VENDORJN_HEOUEST operation 
is used lo generate a class or vendor specific device request with a data 
transfer direction from device to host 



lpInBuffer 



nlnBuf f ecSize 



Pointer to a butter that contains an 

USBIO_CLASS_OR_VENDOR_REGUEST (page 196) data structure 
This data structure has to be filled completely by the caller 

Specifies the size, in bytes, of the buffer pointed to by IpInBuf f er. 
which has to be sizeof(USBIO_CLASS_OH_VENDOR_REOUEST) for 
this operation, 

lpOutBuf f er Pointer lo a buffer that receives the data transferred from the device 
during the data phase of the control transfer. If the request does not 
return any data this value can be NULL 

nOutBuf f erSize Specifies the size, in bytes, of lhe buffer pointed to by lpOutBuf fer. If 

this value is set to zero then there is no data transfer phase . 

Comments A SETUP request appears on the default pipe (endpoint zero) ol the 

USB ctevice wrth the given parameters. If a data phase is required an IN 
token appears on the bus and the successful transfer is acknowledged 
by an OUT token with a zero length data packet. If no data phase is 
required an IN token appears on the bus with a zero length data packet 
from tte USB device for acknowledge. 
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IOCTL USBIO CLASS OR VENDOR OUT REQUEST 



The IOCTL JJSBIO_CLASSJ3RJ/ENDORjDUT_REOUE9T 
operation is used to generate a class or vendor s pec Iftc device request 
with a data transfer directon from host to device. 



lpInBuffer 



Pointer to a butler that contains an 

USBIO_CLASS_OR_VENDOR_REQUEST (page 196) data structure 

lied completely by the caller. 



This data structure has to be 



nlnBuf f ecSite 



Specifies the size, in bytes, ot the butter pointed to by IpInBuf £er t 
Which has to be sizeot(USa[0_CLASS_OH_VENDOR_REOUESTJtor 
this operation. 

lpOutBuf f er Pointer to a butter that contains the data to be transferred to the device 
during the data phase ot the control transfer, it the request has no data 
phase this value can be NULL 

nOutBuf f ©rSize Specifies the size, in bytes* ot the butter pointed to by lpOutBuf fer. It 

this value is set to zero then there is no data transfer phase . 

Comments A SETUP request appears on the default pipe (endpoint zero) of the 
USB device with the given parameters. If a data phase is required an 
OUT token appears on the bus and the successful transfer is 
acknowledged by an IN token with a zero length data packet from the 
device. If no data phase is required an IN token appears on the bus and 
the device acknowledges with a zero length data packet. 
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IOCTL USBIO GET DEVICE PARAMETERS 



lpInBuf fer 

nlnBuff erSize 

lpOut Buffer 

nOut Buffer Size 



Comments 



The IOCTL_USBIO_GET_DEVICE_PARAMETERS operation returns 
USBIO settings related to a device. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

Pointer to a butter that will receive an USBIO_DEVICE_PARAMETERS 
(page 19B) data structure. 

Specifies the size. In bytes, ol the butter pointed to by lpOutBuf f er, 
which has to be at least 3izeot(USBIO_DEVICE_PARAMETERS) for 
this operation 

The detault stale of the device parameters is defined by a set ot registry 
parameters which are read by the USBIO driver ai sfartup. The current 
state may be queried using this requast. 



Designer Reference Manual 



U5B0E Evaluation Board 



164 



Universal USG Device Driver (USBIO) 



MOTOROLA 



Uriver&al US8 De-vice Driver (USBIO) 
Programming Interlace 



IOCTL USBIO SET DEVICE PARAMETERS 



lpInBuf fer 



nlnBuf f erSrxe 



lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTL_USBIO_SET_DEVICE_PARAMETERS operation is used to 
set USBIO parameters related to a device, 

Pointer to a buffer that contains an USB K>_DEVtCE_P ARA METERS 
(page 198) data structure. This data structure has to be filled completely 
by lhe caller 

Specifies the size, in bytes, ol the buffer pointed to be lplnBuf f er, 
which has to be sizeot(USBIO_DEVlCE_PARAMETERS) for this 
operation 

Not used with this operation. Set to NULL, 

Not used with this operation. Set to zero. 

The default state of the device parameters is defined by a set of registry 
parameters which are read by the USBIO driver at slartup,The current 
state may be modified using this request. 
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IOCTL USBIO GET CONFIGURATION INFO 



lpInBuffer 

nlnBuf f erSize 

lpOutBuf fer 

nOutBuff erSize 
Comments 



The IOCTL_USBIO_GET_CONFIGURATIONJNFO operation returns 
information about the pipes and interfaces that ore available alter the 
device is configured. 

Not used with this operation. Set to NULL 

Not used with this operation. Set to zero. 

Pointer to a buffer that will receive an USBK>_CONFtGURATIONJNFO 
(page 204) data structure. 

Specifies the size, in byles. of the buffer pointed to by lpOutBuf f er 
which has to be at least sizeot(U3BIO_CONFIGURATIONJNFO) for 
this operation, 

This operation returns information about all active pipes and interfaces 
that are available In the current configuration. 
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IOCTL USBIO RESET DEVICE 



lpInBuf fer 

nlnBuff erSize 

lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTL_USBIO_RE3ET_DEVICE operatbn causes a reset al the 
hub port in which the device is plugged in* 

Not used with this operation. Set to NULL. 

Not used with this operation. Se! to zero. 

Not used with this operation. Set to NULL, 

Not used with this operation. Se! to zero. 

The foltowing events occur on the bus if this request is issued: 
USB Resel 

GET_DEVICE_DESCRIPTOR 
USB Resel 
SET_ADDRESS 
GET_DEVICE_DESCRIPTOR 
GET_CONFIGURATION_DESCRIPTOR 

All pipes associated with the device will be unbound and all pending 
requests Will be cancelled. Note that the devee receives two USB 
Resets and a new USB address is assigned by US80 After this 
operation the device is in the unconfigured state 

The USBIO driver allows an USB reset request only if the device is 
configured. That means IOC TL_USB10_SET_CON FIGURATION 
(page 159) was successfully executed If the device is in the 
unconfigured state this request returns with an error status. This 
limitation (s caused by the behaviour of Windows 2000. A system crash 
would occur on Windows 2000 if an USB Reset would be issued for an 
unconfigured device. Therefore, USBIO does not allow to issue an USB 
Reset white the device is configured. 

If the device changes its USB descriptor set during an USB Reset the 
KDCTL_USBIO_CYCLE_PORT (pag? 1 72J request should be used 
instead of IOCTLJJSBIO_RESET_DEVICE. 

This request does not work (I the system-provided multi-Interlace driver 
is used. 



us 



Evaluation Board 



Designer Reference Manual 



MOTOROLA 



Universal USB Device Driver {US BO) 



167 



Universal USB Device Driver (USBIO) 



IOCTL USBIO GET CURRENT FRAME NUMBER 



lpXnBuffer 

nlnBuff etSue 

lpOutBuf fer 

nOutBuf ferSice 
Comments 



The IOCTL_USBIO_GET_CURRENT_FRAME_NUMBEB operation 
returns lhe current value of the trame number counter that is maintained 
bytheUSBD, 

Not used with this operation. Set to Null* 

Not used with this operation. Sei to zero. 

Pointer to a butter that will receive an USBIO_FRAME_NUMBER 
(page 205) data structure. 

Specifies the size, in bytes, of the buffer pointed to by lpOutBuf f er F 
which has to be at least sizeof(USBIO_FHAME_NUMBER) for this 
operation. 

The returned frame number is a 32 bit value. The lower 1 1 bits of this 
value correspond to the frame number value in the Start Of Frame toKen 
on the bus. 
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IOCTL USBIO SET DEVICE POWER STATE 



lpInBuf fer 
nlnBuff erSize 

lpOut Buffer 

nOutBuff erSize 

Comments 



See Also 



The IOCTL_USBK3_SET_DEVICE_POWER_STATE operation sets the 
power state ot lhe device. 

Pointer to a buffer that contains an USB tO_DEVtC EMPOWER 
(page 206) doto structure. 

Specifies the size. In bytes, ot the buffer pointed to by IpInBuf f er. 
which has to be at least 5izeot(USBlO_DEVICE_POWER} for this 
operatioa 

Not used with this operation. Set to NULL, 

Not used with this operation. Set to zero. 

The device power state is maintained internally by the US8IO driver 
This request may be used to change the current power stole. 

If the device is set to a power state different from DO all pending requests 
should be cancelled before* 

See EA3 Power Management (page 146) and the description of the 
data structure USB IO_DE VIC EMPOWER (page 206) tor details. 
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IOCTL USBIO GET DEVICE POWER STATE 



lpInBuf fer 

nlnBuff erSize 

lpOut Buffer 

nOut&uf ferSize 



Comments 



The IOCTL_USBIO_GET_DEVICE_POWER_STATE operation returns 
the current power slate ol lhe device. 

Not used with this operation Sel to NULL. 

Not used with this operation. Se! to zero. 

Pointer lo a butter that will receive an USB KM5EVIC EMPOWER 
(page 206) data structure. 

Specifies the size. In bytes, ol the butter pointed to by IpOut Buffer, 
which has to be at least 5izeot(USBlO_DEVICE_POWER) for this 
operation 

The device power state is maintained internally by the USBIO driver 
This request may be used lo query the current power state 
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IOCTL USBIO GET DRIVER INFO 



lpXnBuffer 

nlnBuff erSize 

lpOutBuf fer 

nOutBuff erSize 
Comments 



The IOCTLJJSBIO_GET_DRIVER_INFO operation returns version 
information about the USBIO API and the driver binary that is currently 
running. 

Not used with this operation. Set to NULL, 

Not used with this operation. Sei to zero. 

Pointer to a buffer thai will receive an USBIO_DRlVERJNFO 
(page 1 66) data structure. 

Specifies the size, in bytes, of the buffer pointed to by lpOutBuf f ©r. 
which has to be at least sizeof(USB[0_DRIVER_INFO) for this 
operation. 

An application shoukj check if the API version ot the driver that is 
currently running matches with the version it expects. 
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IOCTL USBIO CYCLE PORT 



lpInBuf fer 

nlnBuff erSize 

lpOut Buffer 

nOutBuff erSize 

Comments 



The IOCTLJJSBIOJ2YCLE_PORT operation causes anew 
enumeration of lhe device* 

Nol used with this operation. Set to NULL. 

Not used with this operation. Se! to zero. 

Not used with this operation. Set to NULL, 

Not used with this operation. Set to zero. 

The IOCTL_US3IO_CYCLE_PORT request is similar to the 
IOCTL_USBIO_RESET_DEVICE (page J 67) request except that from 
the software point of view a disconnect/connect is simulated* This 
request causes the following events to occur: 

- The USBIO device instance that is associated with the USB 
device will be removed. The corresponding device handles 
become invalid and should be closed by the application 

— The operating system starts a new enumeration of thedevte. The 
following events occur on the bus: 

USB Beset 

GET_DEVICE_DESCRIPTOR 

USB Reset 

SET_ADDRESS 

GET_DEVICE_DESCRIPTOR 

GET_CONFIGURATION_DESRIPTOR 

- A new device instance is created by the USBIO driver. 

— The application receives a PnP notifcatbn that informs it about 
the new device inslance. 

After an application issued this request it should close all handles lor the 
current device. It can open the newiy created device instance after it 
receives the appropriate PnP notification. 
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This request should be used Instead of 

IOCTL_USBIO_RESET_DEVICE (pMe 1 07) ii the USBdevice modrtes 
it 5 descriptors during an USB Reset Particularly, this is required to 
implement the Device Firmware Upgrade <DFU) device class 
specification. Note that the USB device receives two USB Resets after 
this Ball This does not conform to the DFU specification However, this 
is the standard device enumeration method used by the Windows USB 
bus driver (USBD). 

This request does not worK if the system-provided multi-interlace driver 
is used. This driver expects that all function device drivers send a 
CYCLE_PORT request within 5 seconds. 
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IOCTL USBIO BIND PIPE 



lpInBuffer 

nlnBuff erSize 

lpOutBuf fer 

nOutBuff erSize 

Comments 



See Also 



The IOCTLJJSBIO_BIND_PIPE operation is used to establish a binding 
between a file handle and a pipe object. 

Pointer to a buffer that contains an USBIO_BIND_PIPE (page 207) data 
structure. This data structure has to be filled completely by the caller* 

Specifies the size, in bytes, of the buffer pointed to by lpInBuf f er. 
which has to be sizeol(USBlO BIND_PIPE) tor this operation, 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

This pipe is identified by its endpoint address. Only endpoints from the 
current configuration can be bound. After this operation Is successfully 
completed the pipe can be accessed using pipe related requests (e.g. 
read or write). 

K>CTL_USBro_SET_CONFIGURATION (page 159) and 
IOCTL_USBtO_GET_CONFIGURATIONJNFO (page 166) 
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IOCTL USBIO UNBIND PIPE 



lpInBuffer 

nlnBuf ferSize 

lpOut Buffer 

nOut Buffer Size 



The IOCTLJJSBIOJJNBIND_PIPE operation deletes the binding 
between a file handle and a pipe object 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 



Comments After this operation is successfully completed the handle is unbound and 
may be used to bind another pipe. It is not necessary to unbind a pipe 
handle before it is closed. Closing a handle unbinds it implicitly. 
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ICOTL USBIO RESET PIPE 



lpInBuffer 

nlnBuf ferSize 

lpOut Buffer 

nOut Buffer Size 

Comments 



The IOCTLJJSBIO_RESET_PIPE operation clears an error condition 
on a pipe. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

If an error occurs while transferring data !rom or to a pipe the USBDhahs 
the pipe and returns an error code. No further transfers can be 
performed while the pipe is hatted. To recover from this error condition 
and to restart the pipe an IOC?L_USBIO_RESET_PIPE has to be sent 
to the pipe. 

This request causes that a CLEAR_FEATURE(ENDPOINT_STALL) 
request appears on the bus. In addition, the endpoint handling in the 
USB host controller will be reinitialized. 

Isochronous pipes will never be halted by the USBD. This is because on 
isochronous pipes no handshake is used to detect errors in data 
transmission. 
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IOCTL USBIO ABORT PIPE 



lpInBuffer 

nlnBuf ferSize 

lpOut Buffer 

nOut Buffer Size 



The IOCTL_USBIO_ABORT_PIPE operation causes that all 
outstanding requests tor the pipe are cancelled. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 

Not used with this operation. Set to NULL. 

Not used with this operation. Set to zero. 



Comments All outstanding read or write requests on the pipe are aborted and 
returned with an error status ol osbio err cancelled 
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IOCTL USBIO GET PIPE PARAMETERS 



lpInBuf fer 

nlnBuff erSize 

lpOut Buffer 

nQut Buffer Size 



Comments 



The IOCTL_USBIO_GET_PIPE_PARAMETERS operation returns 
USBIO settings related to a pipe. 

Not used with this operation Set to NULL. 
Not used with this operation. Set to zero- 
Pointer to a buffer that will receive an usbio_piph_p arame ters 
(page 20B) data structure. 

Specifies the size, in bytes, ol the buffer pointed to by lpOutBuf f er, 
which has to be at least sizeof(USBIO_PIPE_PARAMETERS} for this 
operation 

The default state ol the pipe parameters is defined by a set of registry 
parameters which are read by the USBIO driver at startup. The current 
state can be queried by using this request, 
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IOCTL USBIO SET PIPE PARAMETERS 



lpInBuf fer 

nlnBufferSixe 

lpOutBuffer 

nOutBuff eiSize 

Comments 



The IOCTL_USBIO_SET_PIPE_PARAMETERS operation is used lo 
sel USBIO parameters related to a pipe, 

Pointer to a buffer that contains an USBIO_PIPE_PARAMETERS 
(page 206) data structure. This data structure has to be filled completely 
by lhe caller 

Specifies the size, in bytes, of the buffer pointed to by lplnBuf £ er. 
which has to be sizeof(USBIO_PIPE_PARAMETERS) torthis operation. 

Not used with this operation. Set to NULL 

Not used with this operation. Set to zero. 

The default stale ot the pipe parameters is defined by a set of registry 
parameters which are read by the U SBIO driver ai startup. The current 
state can be modified by using this request 
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IOCTL USBIO PIPE CONTROL TRANSFER IN 



lpInBuffer 



The IOCTL_USBIO_PIPE_CONTROL_TRANSFERJN operation is 
used to generate a specific request (setup packet) tor a control pipe with 
a data transfer direction from device to host- 
Pointer to a butler that contains an 

USBIO_PIPE_CONTROL_TRANSFER (p^e 209) data structure. This 
data structure has to be filled completely by the caller 



nlnBuf f erSize Specifies the size, in bytes, ot the buffer pointed to by lpInBuf fer, 

Which has to be sizeof(USBIO_PIPE_CONTROL_TRANSFER) for this 
operation. 

lpOutBuf f er Pointer lo a buffer that receives the data transferred from the device 
during the data phase of the control transfer, If no data transfer is 
required the pointer may be NULL 

nOutBuf f erSixe Specifies the si2e. in bytes» ol the buffer pointed to by lpOutBuf fer. If 

this value is set to zero then there is no data transfer phase . 

Comments This request is intended to be used with additional control pipes a device 
might provide. II is not possible to generate a control transfer for the 
default endpoint zero with this operation. 
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IOCTL USBIO PIPE CONTROL TRANSFER OUT 



lpInBuffer 



The IOCTL_USBIO_PIPE_CONTi=»OL_TRANSFEHJDUToperaUon is 
used to generate a specific request (setup packet) Tor a control pipe with 
a data transfer direction from host to device. 

Pointer to a butler that contains an 

USBIO_PIPE_CONTROL_TRANSFER (p^e 209) data structure. This 
data structure has to be tilled completely by the caller 



nlnBuf f erSlxe Specifies the size, in bytes, of the butter pointed to by IpInBuf £ er. 

Which has to be 5izeot(USBIO_PIPE_CONTROL_TFtANSFEHJ for this 
operation. 



IpOut Buffer 



Pointer to a butter that contains the data transferred to the device during 
the dala phase ol the control transfer it no data Iranster is required the 
pointer may be NULL 



nOutBuf f erSize Specifies the 3Í2e. in bytes* ot the butter pointed to by lpOutBuf fer. It 

this value is set to zero then there is no data transfer phase . 

Comments This request is intended to be used with additional control pipes a device 
might provide. It is not possible to generate a control transfer for the 
default endpoint zero with this operation. 
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E.5,3 Data Transfer Requests 



The USBlOdevtednVerexports an interface to USB pipes lha! is similar 
to files. For thai reason lhe Win32 API functions ReadFile and 
WnteFile are used to transferdata from or to a pipe. The handle that 
is associated with the USB pipe is passed as hFile to this function 

The ReadFile function is defined as follows: 
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The WriteFile function is defined as follows: 
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By using these functions it is possible to implement both synchronous 
and asynchronous data transfer operations* Both methods are fully 
supported by the USBIOdrjver. Refer to the Microsoft Platform SDK 
documentation lor more Information on using the ReadFile and 
WriteFile functions. 



E*5*3, 1 Bulk and Interrupt Transfers 



For interrupt and bulk transfers the buffer size can be larger than lhe 
maximum packet size of the endpoinl (physical FIFO size) as reported 
in the endpoint descriptor. But lhe buffer size has lo be equal or smaller 
than the value specified in lhe MaximumTransferSize field of the 
USBIOJNTERFACE_SETTlNG (page 194) structure on the Set 
Configuration call 
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Bulk or Interrupt Write Transfers 

The write operation is used to transfer data from the host (PC) to the 
USB devce. The butter is divided into data pieces (packets) ot the 
FIFO size of the endpoint These packets are sent to the USB device, 
lithe last packet of the buffer is smaller than the FIFO si2e a smaller 
data packet is transferred. If the size of the last packet of the buffer is 
equal to the FIFO size this packet is sent. No additional zero packet 
is sent automatically. To send a data packet with length zero, set the 
buffer length to zero and use a NULL buffer pointer 

Bulk or Interrupt Read Transfers 

The read operation is used to transferdata from the USB device to the 
host (PC). The buffer is divided into data pieces (packets) of the FIFO 
size of the endpoint. The buffer size should be a multiple of the FIFO 
size. Otherwise the last transacton can cause a buffer overflow error 
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Figure E-3. Layout of an Isochronous Transfer Buffer 
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A read operation will becompteted if lire whole butler Is filled or a short 
packet is transmitted. A short packet is a packel that is shorter than the 
FIFO size of the endpoint. For more information on receiving short 
packets see below. To read a data packet with o length ol zero, the 
buffer size has to be at least one byte. A read operation with a NULL 
buffer will be completed with success by the system without performing 
e read operation of the USB. 

The behavior of the read operation depends on the state of the flag 
usbio_short_trawsfer_ok of the related pipe. This setting may be 
changed by using the IOCTL_US8IO_SET_PIPE_PARAMETERS 
(page 1 79) operation. The default state is defined by the registry 
parameter ShortTransferOk, If the flag 

USBlO_SHORT_TRANSFER_OK is set a read operation that returns a 
data packet that is shorter than the FIFO size of the endpoint is 
completed with success. Otherwise, every data pochel from the endpoint 
that is smaller than the FIFO size causes an error. 



E.5.3.2 Isochronous Transfers 



For isochronous transfers the data bulfer that is passed to the 
ReadFile or WriteFile function has to contain a header that 
describes the location and the size of the data packets to be transferred, 
Therefore, the buffer that follows the header is divided Into packets* 
Each packet is transmitted within an USB frame (normally I ms). The 
sizeol the packet con be different in each frame. This allows to support 
any data rate of the isochronous data stream. 

The structure of the data buffer is shown in Figure E-3. The buffer 
contains an USBtO_ISO_TRANSFER_HEADER (page 21 3| structure 
of variable size at offset zero and the data packets. The header contains 
an U3BIO_ISO_TRANSFER (page 210) structure that provictes general 
information about the transfer buffer. An important member of this 
structure is the N um be rOf Packets parameter. This parameter specifies 
the number of data packets contained in the transfer buffer The 
maximum number of packets that can be used in a single transfer is 
limited by the registry parameter MaxIaoPackets Each data packet 

has to be described by an USBtO_ISO_PACKET (page 212) structure 
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In the header Because ollhat. lhe header contains a variable s(2e array 
of USBtO_fâO_PACKET (page 21 2) elements. 

TheOt(set memberol lhe USBIO_ISO_PACKET structure specifies lhe 
byte offset of the corresponding packet relative to the beginning of the 
whole buffer and has to be filled by lhe application lor write and for read 
transfers. The Length member defines the length, in bytes* of the packet 
The packet length has to be specified by the application forwrrte 
transfers and is returned by the USBIO on read transfers. The Status 
member is used to return the completion status of lhe transfer of the 
packet 

Isochronous Write Transfers 
The sizes otthe packets have to be less than or equal to the FIFO size 
ottheendpolnt There must not be gaps between the data packets in 
the transfer buffer The Offset and Length member of the 
USBIOJSO_PACKET structures have to be initialized correctly 
before the transfer is started. 

Isochronous Read Transfers 

The size of each packet should be equal to the FIFO size Otherwise 
a dala overrun error can occur. TheOflsel member of the 
USBIO_ISO_PACKET structures has to be initialized correctly before 
the transfer is started. There must not be gaps between the data 
packets in the Iransfer buffer. The length of each received data packet 
is returned in the Length member of the corresponding 
USBIO_ISO_PACKET structure when the transfer completes. 

NOTE: Because thestze of the received packets may be less than the FtFOsize 
the data packets are not arranged continuously within the transfer buffer. 



E.5-4 Input and Output Structures 



This section provides a detailed description of the data structures that 
ate used with the various input and output requests. 



USB08 Evaluation Board Designer Reference Manual 

MOTOROLA Universal USB Device Driver (USBC) 195 



Universal USB Device Driver (USBIO) 



US8IO_DRIVERJNFO 

The USBIO_DRlVER_INFO structure contains version information 
about ths driver binary and the programming interface. 

Definition typedef struct _U5BI0_DRIVER_INFO| 
UStiORT APIVersion; 
USHORT DriverVersion; 

ULONG DriverBuildHumber; 
ULONG Flags; 

i USBIO_DRIVER_INFO; 

Members APIVersion 

Contains the version number of the application programming 
interface (API) the driver supports. 

The format is as follows: upper 6 bit = major version, 

lower B bit = minor version. The numbers are encoded in BCD format 

DriverVersioa 

Contains the version number of the driver executable 

The formal is as follows; upper 8 bit = major version, 
lower 8- bit = minor version. 

DriverBuildNumber 

Contains the build number of the driver executable. 

Flags 

This feld contains 2ero or any combinaton (bit-wise or) of tr>3 

following values. 

USBIOJNFOFLAG_CHECKED_BUtLD 

If this flag is set, the driver that is currently running is a checKed 

(debug) build 
USBIOJNFOFLAG_DEMO_VERSION 

If this flag is set the driver thai is currently running is a DEMO 

version thai has some restrictions. Refer to ReadMe.txt for a 

description of the restrictions. 
USBIOJNFOFLAG_LIGHT_VERSION 

If this flag is set, the driver that is currently running is a LIGHT 

version thai has some restrictions. Refer to ReadMe.txt for a 

description of the restrictions. 

Comments This structure is an output of the ©CTL_USBIO_GET_DRlVERJNFO 
(page 1 71 ) operation. 
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USBIO DESCRIPTOR REQUEST 



Definition 



MemCers 



Commenls 



The USaiO_DESCRIPTOR_REGUEST structure provides information 
used lo gel or set e descriptor 

typedef struct _USaiC_DES<:RJPTOR^REQUEST ( 
UE6IO_RE0U£ST_P^CIPIENT Recipient; 
oCflAR DescriptorTypej 
UCHAR Descriptorlndex; 
USKOP.T Languageld; 
\ OSBIO_DESCRIPTOR_REQUEST; 

Recipient 

Specifies lhe recipient ot the gel or set descriptor request The values 
are defined by the enumeration type 
USBK>_REaUEST_RECIPIENT (page 215), 

Descriptor Type 

Specifies the type of descriptor to get or set. The values are defined 
by the Universal Serial Bus Specific at on 11. Chapter 9 and 
additional device class specifications. 



Valus 

1 
2 
3 
4 
5 
21 



Meaning 

Device Descriptor 
Configuration Descriptor 
Siring Descriptor 
Interface Descriptor 
Endpoml Descriptor 
HID Descriptor 



Descriptor Index 

Specifies the index of the descriptor to get or set. 

Language Id 

Specifies the Language ID for string descriptors. Set to zero for other 
descriptors. 

This structure has to be used as an input for 
IOCTL_USBK>_GET_DESCRIPTOR (page 151) and 
IOCTL_USB_SET_DESCRIPTOR (page 152) requests. 
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US8IO_FEATURE_REQUEST 

The USBlO_FEATURE_REQUEST structure provktes information used 
to set or clear a specific feature. 

Definition typedef struct _USBIC_FEA7URE_RE0UEST| 
*JSBIO_REQUSST_PZCIPIEKT Recipient; 
USflOR? FeatureSelector; 
USflORT Index; 
| aSBIO_FEATURE_R£QOEST; 

Members Recipient 

Specifies the recipentof the set feature or clear feature request. Tte 
values are defined by the enumeration type 
USBIO_REQUEST_RECIPIENT (page 215). 

FeatureSelector 

Specifies the feature selector value for the set feature orclear feature 
request. The values are defined by the recipient Refer to the 
Universal Serial Bus Specification 1,1» Chapter 9 for more 
information 

Index 

Specifes the index value for the set feature or clear feature request. 
The values are defined by lhe device Refer to the Universal Serial 
Bus Specification 1.1, Chapter 9 tor more information. 

Comments This structure has to be used as an input for 

IOCTL_USB10_SET_FEATURE (page 153) and 
K>CTL_USBIO_CLEAR_FEATURE{page 154) requests. 
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USBIO STATUS REQUEST 



The USBIO_STATUS_BEQUEST structure provides information used 
to request status tor a specified recipient 

Definition typtdtrf struct _USBIC_STA7UE_REQUEST ) 
US6Iú_RE0U£ST_P.ECIPIEN7 Recipient; 
USflOR? Index; 
I OSBIO_STAT0S_REQUEST; 

Members Recipient 

Specifies the recipient of the gel status request The values are 
defined by the enumeration type USBIO_REQUEST_RECIPIENT 
(page 215). 

Index 

Specifies the index value for the get status request* The values are 
defined by the device. Refer to the Universal Serial Bus Specification 
1.1, Chapter 9 for more information. 

Comments This structure has to be used as an input tor 

iOCTL_USBIO_GET_STATUS (page 155) requests. 
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USB1O_STATUS_REQUEST_0ATA 

The USBlO_STATUS_REQUEST_DATA structure contains information 
returned by a get status operation. 

Definition typedef struct _USBI0_STATUS_REQUES1_DATAI 
USHORI Status; 
I OSBIO_STATOS_REQUEST_DATA; 

Member status 

Contains the 1 6-bit value that is returned by the recipient in response 
to the get status request. The interpretation of the value is specific to 
the recipient. Refer to the Universal Serial Bus Specification 1,1. 
Chapters for more information 

Comments This structure is an output of IOCTL__USBIO_GET_STATUS (page 155} 
requests. 
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USBIO GET CONFIGURATION DATA 



The USBIO_GET_CONFIGURATION_DATA structure contains 
Information returned by a get configuration operation. 

Definition typedef struct _USaiG_GET_CONFIGURATION_DATA| 
tiCHAP. Conf igurat ionValue; 
I USBIO_GET_CONFIGURATION_DATA; 

Member Conf igurat ionValue 

Contains the 8-bif value that Is returned by the device in response to 
the get configuration request The meaning of the value is defined by 
the device. A value of zero means the device Is not configured Refer 
to the Universal Serial Bus Specrlication U, Chapter 9 lor more 
information 

Comments This structure is an output ot IOCTL_USBIO_GET_CONFIGURATION 
(page 156) requests* 
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USB10_GET_INTERFACE 

The USBIO_GETJNTERFACE structure provides informaton used to 
request the current alternate setting of on interface. 

Definition typedef struct _USaiC_GET_INTERFACE( 
USH0P.7 Interface; 
\ OSBIO_GET_INTERFACE; 

Member Interface 

Specifies Uie interlace number. The meaning is device-specific. Refer 
to the Universal Serial Bus Specification 1.1, Chapters for more 
information. 

Comments This structure has to be used as an input for 

roCTL_USBK)_GETJNTERFACE{page 157) requests. 
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USBIO GET INTERFACE DATA 



The USaiO_GET_!NTERFACE_DATA slruclure contains inlormalion 
returned by o get interface operation. 

Definition typedef struct _USaiCJ3ET_INTERFACE_DATA( 
UCHAP- AlternateSetting; 

) usbio_get_interface_data; 

Member AlternateSetting 

Contains the 8-bit value thai Is returned by the device in response to 
a get interface request The interpretation of the value is specific to 
the device. Refer to the Universal Serial Bus Specification 1.1, 
Chapters for more information 

Comments This structure is an output of IOCTL_USBIO_GETJNTERFACE 
(page 157) requests. 
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The USBIOJNTEPFACE_SETTING structure provides information 
used to configure an interface and rts endpoints. 

Definition typedef struct _USaiC_INTi-PrACL_SET7ING( 
USH0R7 Interfacelndex; 
USDORT AlternateSettmglndex; 
ULOHG MamimumTr ansf erSxze; 
| USBIO_INTBRFACE_SETTING; 

Members Interfacelndex 

Specifies the interface. The value is defined by the device. Refer to 
the Universal Serial Bus Specification Ijl, Chapters for more 
information 

Alt e mat e Sett ing Index 

Specifies the alternate setting to be set for this interlace. The value is 
defined by the device. Refer to the Universal Serial Bus Specification 
1.1, Chapter 9 for more information. 

Max imumT r ans f e r S i ze 

Specifies the maximum size, tn bytes, of data transfers to or from 
endpoints of this interface. The value is U3er-defined and is valid for 
allendpointsot this interface. If no special requiremenl exists a value 
of 4096 (4K) should be used. 

Comments This structure nas to be used as an input for 

IOCTL_USBtO_SET_INTERFACE(page 161) and 
rOCTL_USBK>_SET_CONFIGURATION (page 159) requests 



Designer Reference Manual 



U5B0E Evaluation Board 



1W 



UriversalUSB Device Driver (USBIO) 



MOTOROLA 



Uri versai US8 De-vice Driver (US BO) 
Programming Interlace 



USBIO SET CONFIGURATION 



The USBIO_SET_CONFIGURATION structure provides information 
used lo set lhe device configuration 

Definition typcdcf struct _USaiC_SET_C0NF:GURA7I0N) 
USKOR? Conf igurationlndex; 
USBOR? KbOf Interfaces; 
USBIO_INTEBFACE_SETTING 

Interf aceLifft (USBIO_MMC_INTERFACE5] ; 
) aSBIO_SET_CONFIGURATION; 

Meffibeo Conf igurat ionlndex 

Specifies (he configuration to be set The meaning of the value is 
defined by the device. Reter to the Universal Serial Bus Specification 
1,1. Chapter 9 for more Information. 

NbOf Interface 

Spectfes the number of Inlerlaces in this configuration. This is the 
number of valid entries inlntertaceList 
InterfaceList [USBIO_MAX_INTERFACES] 

An array of USBK>JNTERFACE_SETTING (page t94> structures 
that describes each interface in the configuration. There have to be 
NbOflnterfaces valid entries in this array. 

Comments This structure has to be used as an input for 

IOCTL_USB10_SET_CONFIGURATION (page 159) requests 
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USBIO_CLASS_OR_VENDOR_REQUEST 

The USaiO_CLASS_OH_VENDOR_REOUEST structure provides 
Information used to generate a class or vendor specific device request, 

Definition typedc é struct _USDIC_CLASS_OR_VEWDOR_REQUEST( 
ULONG Flags; 

USBIO_RE0UEST_TYPE Type; 
US6IO_RE0UEST_RECIPIENT Recipient; 
'JCHAR RequestTypeReservedBits; 
UCBAR Request; 
USflORT Value; 
UEHOP" Index; 
i USBIO_CLASS_OR_VENDOR_REQlJEST; 

Members Flags 

This ffâld contains zero or the following value. 

USBIO_SHORT_TRANSFER_OK 

If this flag is set, the USBIO driverdoes not return an erionl adata 
packet received from the device is shorter than the maximum 
packet size of the endpoinL Otherwise, a short packet causes an 
error condition. 
Type 

Specifies the type of the device request The values are defined by 
the enumeration type USBIO_REOUEST_TYPE (page 21 6), 

Recipient 

Specifies the recipient of the device request. The values are defined 
by the enumeration type USBK>_REQUEST_RECIPIENT 
(page 215). 

Request TypeReservedB its 

Spectfes the («served bits of the bmRequestType field of the setup 
packet. 

Request 

Specifies the value ol the bRequest field of lhe setup packet. 

Value 

Specifies the value of the wValue field of the setup packet. 

Index 

Specifies the value ol the wlndex fletlol the setup packet. 
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Comments The values defined by this slruclure are used lo generate an eight byte 
setup packet for the control endpoint of the device. The format of the 
setup packet is defined by lhe Universal Serial Bus Specification 1.1. 
Chapters. The meanings ol the values are device dependent. 

This structure has to be used as an input for 

IOCTL_USBK)_CLASS_OR_VENDORJN_REOUEST (page 162) and 
IOCTL_USBIO_CLASS_OR_VENDOR_OUTJ}EQUECT (page 163) 
operations. 
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USBIO_OEVICE_PARAMETERS 

The USBIO_DEVICE_PARAMETERS stricture contains 
device- specific parameter settings of the USBIO driver 

Definition typedef struct _USBIO_DEVICE_PARAMETERS ( 
ULONG Options; 
ULONG RequestTimeout ; 
i USBIO_DEVICE_PARAMETERS; 

Members Opt i ons 

This field contains zero or any combination (brt-wise or) of the 
following values. 
USBIO_RESET_DEVICE_ON_CLOSE 

If this option is set the USBIO driver generates an USB device 
reset after the last handle to the device was closed by the 
application. When this option is active the 
usbio_unconfigure_on_close flag will be ignored. 

The default state of this option is defined by the registry parameter 
ResetDeviceOnClose* 
USBIO_UNCONFIGURE_ON_CLOSE 

If this option is set the USBIO driver sets the USB device to its 
unconfigured state after the last handle to the device was closed 
by the application. 

The default state of this option is defined by the registry parameter 
Unconf igureOnClose. 
USBIO_ENABLE_REMOTE_WAKEUP 

If this option is set and the USB device supports the Remote 

Wakeup feature the USBIO driver will support Remote Wakeup for 

the operating system. The USB device is able to wake the system 

from a sleep state. The Remote Wakeup feature is defined by the 

USB 1.1 specification. 

The Remote Wakeup feature requires that the device is opened by 

an applcation and an USB configuration is set (device is 

configured). 

The default state of this option is defined by the registry parameter 

EnableRemoteWakeup. 
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Request Timeout 

Specifies lhe time-out interval» In milliseconds, lo be used lor 
synchronous operations A value ol zero means an infinite interval 
(time-out disabled). 

The default time-out value is defined by the registry parameter 
Request Timeout . 

Comments This structure is intended to be used with 

IOCTL_USBIO_GET_DEVrcE_PARAMETERS (pa^3 1 64) and 
IOCTL_USBIO_SET_DEVCE_PARAMETERS (page 165) operations. 
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USBIOJNTERFACE_CONFIGURATK>NJNFO 

The USBIOJNTERFACE_CONFIGURATION_INFO structure provides 
information about an interlace. 

Definition typedef struct _USBI0_IOTERFACE_C0NFIGURATI0N_INF0 { 
UCHAR InterfaceNumber; 
UCHAR AlternateSetting; 
UCHAR Class; 
UCHAR Subclass; 
UCHAR Protocol; 
UCHAR NumberOf Pipes; 
UCHAR reservedl; 
UCHAR reserved2; 
| USBIO_INTERFACE_CONFIGDRATION_INFO; 

Members InterfaceNumber 

Specifies the index of the interface as reported by the device in the 
configuration descriptor. 

AlternateSetting 

Specifies the index of the alternate setting as reported by the device 
in the configuration descriptor The default alternate setting of an 
interface is zero. 

Class 

Specifies the class code as reported by the device in the configuration 
descriptor. The meaning of this value is defined by the USB class 
specifications. 

Subclass 

Specifies the subclass code as reported by the device in the 
configuration descriptor. The meaning of this value is defined by the 
USB class spec if cations. 

Protocol 

Specifies the protocol code as reported by the device in the 
configuration descriptor. The meaning of this value is defined by the 
USB class specifications. 

Numbe r Of P ipe s 

Specifies the numberof pipes that belong to this interface and 
alternate setting. 
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reservedl 

Reserved fieW, set to zero 
reserved2 

Reserved fieW, set to zero 

Comments This structure Is an output ot 

IOCTL_USBK>_GET_CONFIGURATIONJNFO(pa^ 166) operstons 
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USBIO_PlPE_CONFKSURATIONJNFO 

The USBIO_PIPE_CONFIGURAT!ONJNFO structure provides 
Information aboift o pipe. 

Definition typedef struct _USBIC_FIPE_COMf IGURATION_INFO( 
US6I0_PIPE_TYPE PipeType; 
ULONG MaximuiaTransf erSxze; 
USflORT HaximumPacketSize; 
UCHAP- EndpointAddresa; 
UCflAR Interval; 
UCflAR InterfaceNumber; 
UCHAP. reservedl; 
UCIIAR reserved^; 
UCflAR reserved3; 
I USBIO_PIPE_CONFXGURATION_INFO; 

Members PipeType 

Specifies the type ol the pipe. The values are detlned by the 
enumeration type USBIO_PIPE_TYPE (page 214). 
MaximumTransf er5ize 

Specifies the maximum size, in bytes, ol data transfers the USBD 
supports on this pipe. This is the maximum size of butters that can be 
used with read or write operations on this pipe. 

Max i mumP a ck et S i 2 e 

Spectfes the maximum packet size of USB data transfers the 
endpoint iscapabteof sending or receiving as reported by the device 
in the corresponding endpomt descriptor. Refer to the Universal Serial 
Bus Specification 1.1, Chapters lor more information. 

Eendpnint Address 

Specifies the address of the endpoint on the USB device as reported 
in the corresponding endpoint descriptor. 

The endpoint address includes the direction flag at bit position 7 
(MSB) 

Bit 7 = 0: OUT endpoint 

Bit 7=1: iNendpoint 
Refer to the Universal Serial Bus Specification 1.1, Chapters for more 
information. 
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Interval 

Specifies lhe interval, in milliseconds, for polling the endpoint lor data 
as reported in the corresponding endpoint descriptor The value i& 
meaningful (or interrupt endpoints only. Refer to lhe Universal Serial 
Bus Specification 1.1, Chapter 9 for more information. 

Int erf aceNumbe r 

Specifies the index of lhe interface the pipe belongs to The value 
corresponds lo the field Interf aceNunber of an 
USBK3JNTERFACE_CONFIGURATION_INFO (page 200) 
structure. 

reservedl 

Fleserved tieU set to zero 

CVMtWS 

Fleserved tieW, set to zero 
reserved3 

Reserved tieW, set to zero 

Comments This structure Is an output of 

IOCTL_USBK>_CET_CONFIGURATIONJNFO(page166)operations. 
Only active pipes from the current configuration are returned* 
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USBIO_CONFIGURATION_INFO 

The USaiO_CONFIGURATIONJNFOstn*cture provides information 
about all interfaces and all pipes available in the current configuration. 

Definition typedcf struct _USBIO_CONFIGURATION_INFO ( 
ULOMG HbOf Interfaces; 
ULONG NbOfPipeaj 
USBI0_INTERf7\CE_C0NFIGURATI0N_rWF0 

Interf acelnf o [aSBIO_MAX_INTERFACE5I ; 
UBBIO_PIPE_CONF IGURAT ION_ ENFD 

Pipelnf o [USBIO_MAX_PIPESJ ; 
I OSBIO_CONFIGURATI0N_INFO; 



Members NbOf Interf ace 

Contains the number of interlaces. Thi 
in the Interf acelnfo structure. 



ig the numberof valid entries 



NbOf Pipes 

Contains the number ot pipes. This is the number of valid entries in 
the Pipelnf o structure 

Interf acelnf o [USBIO_HAX_INTERFACES] 

An array ot USBIOJNTERFACE_CONRGUFIATIONJNFO 
(page 200) structures that describes the InlerlacesThere are 
NbOf Interf aces valti entries in this array 

Pipelnf o [U5BIO_MAX_PIPES] 

An array of USBIO_PIPE_CONFIGURATIONJNFO (page 202) 
structures that describes the pipes. There are NbOfPipes valid 
entries in this array. 

Comments This structure is an output of 

!0CTL_USBtO_GET_CONFIGURATlONJNFO (page 166)ope rations 
Only active pipes Irom the current configuration are returned. 
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U5BIO FRAME NUMBER 



The USB10_FRAME_NUMBER structure contains information about the 
USB frame counter value* 

Definition typcdcf struct _USaiC_FR?\KE_NUMBERl 
ULONG FraneNumber; 
1 USBIO_FRAME_NUHBER; 

Members FrameNumber 

Contains the current value of the trame counter maintained by the 
USBD. 

Comments This structure is an output ot 

tOCTL_USBK>_GET_CURRENT_FRAME_NUMBER (page 168) 
requests. 
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USBIO_DEVICE_POWER 

The USBIO_DEVICE_FOWER structure contains information about the 
USB device power states. 

Definition typtdef struct _USBI0_DEVICE_POWER) 

uS6I0_DEVICE_P0WER_STATE DevicePowerState; 
I OSBIO_DEVICE_POWER; 

Member DevicePowerState 

Contains the power state of the USB device. The values are defined 
by the USBIO_DEVICE_POWER_STATE (page 2i 7) enumeration 

type. 

Comments This structure is used with 

10CTL_USB10_GET_DEV1CE_P0WER_STATE (page 170) and 
IOCTLJJSBK>_SET_DEVICE_POWER_STATE(page 169) requests 
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USBIO BIND PIPE 



The USBIO_BIND_PIPE structure provides information about lhe pipe to 
bind to. 

Definition typedef struct _USBIO_BIND_PIPE) 
UCHAP. EndpointAddreas; 
) USBIO_BIND_PIPE; 

Member Endpoint Address 

Specifies lhe address of the endpoint on the USB devfce that shall be 
associated with the pipe The endpoint address is specified as 
reported in lhe corresponding endpoint descriptor. 

The endpoint address includes the direction flag at bit position 7 
(MSB). 

Bit 7= I; OUT endpoint 

Bit 7 = 0: IN endpoint 
Refer to the Universal Serial Bus Specification 1-1. Chapters for more 
information. 

Comments This slructure has to be used as an input torlOGTLJJSBIO_BIND_PlPE 
(page 1 74) operations. Only active endpoints from the current 
configuration can be bound. 
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USB10_PIPE_PARAMET£RS 

The USaiO_PIPE_PARAMETERS structure contains pipe specific 
parameter settings of the USBIO driver 

Definition typedef struct _USBIC_PIPL_PAFAMETERS( 
ULOMG Plage; 

* USBIO_PIPB_PARAMETERS; 

Member Flags 

This field contains zero or the following value, 
USBIO_SHORT_TRANSFER_OK 

It this Hag is set, lhe USBIO driver does no! return an error during 
read operations trom a Bulk or Interrupt pipe if a packet received 
from the device is shorter than the maximum packet size of the 
endpoint Otherwise, a short packet causes an error condition. 
This option is meaningful for IN pipes only. 

Comments This structure is intended to be used with 

K>CTL_USBIO_GET_PIPE_PARAMETERS (page 178) and 
IOCTL_USBK>_SET_PIPE_PARAMETERS (page 179} operations, 
The defauli setting ot this parameter can be changed by means of the 
registry parameter ShortTransferOfc This parameter has an effect 
only lor lead operations from Bulk or interrupt pipes. For Isochronous 
pipes the Hags in the appropriate I SO data structures are used (see 
USBO_ISO_TRANSFER (page 210)). 
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USBIO PIPE CONTROL TRANSFER 



The USBIO J > IPE_CONTROL_TRANSFER structure provides 
Information used to generate o specific control request. 

Definition typedef struct _USSTC_PIPL_C0H7FDL_TFANSf ER| 
uLONG Flags; 

UCI1AR SetupPacket [8]; 

I USBIO_PIPB_CONTROL_TRAHSFER/ 

Members Flags 

This field contains zero or the following value. 

USBIO_SHORT_TRANSFER_OK 

II this tlagis set, the USBIO driverdoes not return an error II adai3 
pacKet received from the device is shorter than the maximum 
packet size of the endpoinL Otherwise, a short packet causes an 
error condition, 
SetupPacket [6] 

Specifies the setup packet lobe sent to the device The format of the 
eight byte setup packet is defined by the Universal Serial Bus 
Specification 1,1, Chapters. 

Comments This structure has to be used as an input for 

IOCTL_USBKD_PIPE_CONTROL_TRANSFERJN (page 180) and 
K3CTLJJSBIO_PIPE_CONTROL_TRANSFER_OUT (page 181) 
operations. 
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USBIO ISO TRANSFER 



The USBIOJSO_TRANSFER stricture provides information used (or 
isochronous data transfers. 



Definition typedef struct _USBI0_ISO_TRANSFER| 
UL0NG NumberOfPackets; 
ULONG Flags; 
ULONG StartFra» 
ULONG ErrorCount; 
i USBIO_ISO_TRANSFER, 

Members NumberOf Packet s 

Specifies the number of packets to be sent to or received from the 
device. Each packet corresponds to an USB frame. The maximum 
numberof packets in a readorwrtte operation is limited by the registry 
parameter MaxIsoPackets. 
Flags 

This field contains zero or any combinatbn (bit-wise or) of the 
following values, 

USBIO_SHORT_TRANSFER_OK 

If this flag is set, the USBIO driverdoes not return an error if adata 
packet received from the device is shorter than the maximum 
packet size of the endpoint. Otherwise, a short packet causes an 
error condition, 

USBIO_START_TRANSFER_ASAP 

If this flag is set, the transfer will be started as soon as possible 
and the StartFrane parameter is ignored. This flag has to be 
used if a continuous data stream shall be sent to the isochronous 
endpointof the USB device, 
StartFrane 

Specifies the frame number the transfer shall start with. The value has 

to be within a system-defined range relative to the current frame. The 

range is normally set to 1 024 frames. 

If USBIO_START_TRANSFER_ASAP is Specified in Flags, this 
member has not to be set by the caller It contains the frame number 
that the transfer started with, when the request is returned by the 
USBIO. 
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If OSBIO_9TART_TRANSFER_ASAP is not Specified In Flags, this 
member has to be set by Ihe calter to the frame number this transfer 
shall start with. An error occurs it the trame number is outside of Ihe 
valid range. 
ErcorCount 

Contains the total number of errors occurred during this transaction 
when the request is returned by the U38IO. 

Comments This structure is the fixed size part of the 

USBIOJSO_TRANSFER_HEADER (page 213) thai has to be used as 
an input for ReadFile and Writ eFile operations with an isochronous 
pipe the transfer buffer has to contain an 
USBIOJSO_TRANSFER_HEADER (page 21 3| structure at offset zero. 
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USB10JSO_P AC KET 

The USBIOJSO_PACKET structure defines the size and location ot a 
single isochronous data packet within the transfer butter thai Is used lor 
isochronous data transfers. 

Definition typedef struct _U5BI0_ISO_PACKETt 
ULONG Offset; 
ULONG Length; 
ULONG Status; 
I USBIO_ISO_PACRET; 

Members Offset 

Specifies the offset, in bytes, of the packet relative to the start of the 
data buffer. This parameter has to be specified by the caller for read 
and write operations. 

Length 

Specifies the size, in bytes* ol the packet. This parameter has to be 
set by the caller for write operatGns On read operations this field is 
set by the USBIO when the request is returned. 

Status 

Contains the final status code for the transfer of this packet when the 
request is returned by the USBIO. 

Comments A variable size array of USBlo_lBO_PACKE7 structures is part of the 
USBIOJSO_TRANSFER_HEADER (page 213) that has to be used as 
an input for ReadFile and Br it eFile operations With an isochronous 
pipe An OSBIO_ISO_PACK£T structure is required for each data packet 
to be transferred. The maximum number of data packets is limited by the 
registry parameter MaxIsoPackets 
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USBK)_tSO_TRANSFER_HEADER 

The USBIOJSO_TRANSFER_HEADER structure defines the header 
that has to be contained In the data butlers that are used for isochronous 
transfere. 

Definition typtdef struct _U5BIO_1SO_TRANSFER_HEADER) 
USBia_IS0_7RANS5ER IsoTransfer; 
USBI0_IS0_PACKE7 IsoPacket [1] ; 
\ USBI0_ISO_TRANSFBR_HEADER; 

Members IsoTransfer 

This is the fixed si2e part of lhe header. See the description of the 
USB10_(SO_TRANSFER (page 210) structure tor more information. 
IsoPacket [1] 
This is a variable length array of USBK>_ISO_PACKET (page 212) 
structures. Each member defines an isochronous packet to be 
transferred. The number of valid entries in this array is cfefined by the 
NumberOf Packets field of IsoTransfer. The maximum number of 
data packets is limited by the registry parameter MaxIsoPackets, 

Comments The data buffer passed to ReadFile orWriteFi_le operations with an 
isochronous pipe has to contain a valid 

US8IOJSO_TRANSFER_HEADER (page 21 3) structure atoffset zero. 
After this header the buffer contains the isochronous data which is 
divided into packets The isoPacket array describes the location and 
the size of the data packets, Each data packet Is transferred In a 
separale USB frame. 

There rnusl not be gaps between the data packets In the transfer bufler. 
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ESS Enumeration Types 

USBIO_PIPE_TYPE 

The U SBIO_PI PEJTYPE enumeration type contains values that identify 
the type ot an USB pipe or an USB endpoint respectively. 

Definition typedef enurn _USBIO_PIPE_TYPE 
PipeTypeControl - 0, ; 
PipeTypelsochronous , 

PipeTypeBulk , 
PipeTypelnterrupt 
) USBIO_PIPE_TYPE; 

Comments The meaning ol the values is deiined by he Universal Serial Bus 
Specification 1.1. Chapters. 
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USBIO REQUEST RECIPIENT 



The USBIO_REQUEST_RECIPIENT enumeration type contains values 
that identity the recipient of an USBdevtee request. 

Definition typcdef enura _USBIO_REQUEST_RECIPIENT I 
Recipient Device ~ 0, 
Recipient Interface, 
Recipient Endpo int , 
Recipient Other 

| USBIO_REQUEST_RECIPIENT; 

Comments The meaning ot the values is ctetined by the Universal Serial Bus 
Specification 1,1. Chapters. 
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USBIO_REQUEST_TYPE 

The USBlO_REGUEST_TYPE enumeration type contains values that 
identify the type ol an USB devce request 

Definition typedef er.urn _USBIO_REQUEST_TYPE \ 
RecfuestTypeClass — 1, 
Re<jue s t Type Vendo r 
) USBIO_REQUEST_TYPE; 

Comments The meaning ot the values is ctelined by the Universal Serial Bus 
Specification 1. 1. Chapter 9. 

The enumeration does not contain the Standard request type defined by 
the US8 Specification. This is because only Class and Vendor requests 
are supported by the USBD interface. Standard requests are generated 
internally by the USBD. 
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USBK>_DEVICE_POWER_STATE 

The USBlO_DEVICE_POWER_STATE enumeration type contains 
values that identify the power state ot a device. 

Definition typedef enura _USBIO_DEVICE_POWER_STATE I 
DevicePowerStateDO - 0, 
DevicePowerStateDl, 
DevicePowerStateD2, 
DevicePowerStateD3 
) USBIO_DEVICE_POWER_STATE; 

Entries DevicePowerStateDO 

Device fully on. normal operation 
DevicePowerStateDl 

Suspend 
DevicePowerStateD2 

Suspend 
DevicePowerStateD3 

Device off 

Comments The meaning of the values is defined by the Power Management 
specification. 
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E.5.6 Error Codes 



Table E-2. Error Codes Defined by the USBIO 

Device Driver 



USBIO_EHR_SUCCESS 

USBIO_ERR_CRC 

USBKD_ERR_8T$TUFF 

USBIO_ERR^DATA_TOGGLE_MISMATCH 

USBIO_ERR,STALL_PID 

USBIO_ERR_DEV_NOT_RESPONDING 

USBiO_ERR_PID_CHECK_ FAILURE 

USBK)_ERR_UNEXPECTED_PID 

USBO_ERR_DATA_OVERRUN 

USBIO_ERR_DATA_UNDERRUN 

USBIO„ERR_RE$ERVED1 

USBIO_ERR_RESERVED2 

USBO_ERR_BUFFERjDVERRUN 

USBIO_ERR_BUFFER_UNDERRUN 

USBCLERR_NOT_ACCESSED 

USBIO_ERR_FIFO 

USBIO_EflR_ENDPOINT_HALTED 

USBIO_ERR_NO_MEMORY 

USBCLERRJNVALID^URB^FUNCTION 

USBIO_ERR_INVALID^PARAMETER 

USBIO_EflR_ERROR_BUSY 

USBIO_ERR_REQUEST^ FAILED 

U$BK)_ERRJNVALID_PIPE_HANDLE 

USBIO_ERR_NO_BANDWIDTH 

USBIO_EflRJNTERNAL_HC_ERROR 

usbio_err^error_$hort_transfer 

usbio„err,bad_start^frame 

usbio_err_isoch_request_failed 

usbio_err_frame..control_owned 

usbio_err,frame^control_not t ov;ned 

usbio.errxanceled 

usbio_err_canceling 

usbio_err_failed 

usbio_err_invali0_inbuffer 

usbio_errjnvaud_outbuffer 

usbio_err_outj3f_memory 

usbio_err_pending_request8 

usbio_err_already^configured 

usbio.err.not^configured 

usbio_err^open_pipes 

usbio_errjvlreadey_bound 



(0x00000000 L) 

(OxEOOOOOOl L) 

(0xE00000O2L) 

fOxE0000003L) 

(OxE0000004L) 

fOxE0000005L) 

(OxE0000006L) 

(OxE0000007L) 

(OxE0000008L) 

fOxE0000009L) 

(OxEOOOOOOAL) 

(OxEOOOOOOBU 

(OxEOOOOOOCL) 

(OxEOOOOOODL) 

(OxEOOOOOOFL) 

(OxEOOOOOIOL) 

(0xE0000030L) 

(OxEOOOOIOOL) 

(0xE0OO0200L) 

(0xE0000300L) 

(0xE0000400L) 

f0xE0000500L) 

(OxE0000600L) 

(OxEOOOOTOOL) 

(OxE0000800L) 

(OxE0000900L) 

(OxEOOOOAOOL) 

(OxEOOOOBOOL) 

(OxEOOOOCOOL) 

fOxEOOOODOOL) 

(OxEOOIOOOOL) 

(OxE0020000L) 

(OxEOOOIOOOL) 

(OxEOOOIOOl L) 

(OxE0001002L) 

(OxE0001003L) 

(OxE0001004L) 

(OxE0001005L) 

(OxE0001006L) 

(OxE0001007L) 

(OxEOOOIOOSL) 
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Table E-2. Error Codes Defined by the USBIO 
Oevice Driver (Continued) 



USBKD_ERR^NOT_B0UND 

USBIO_ERR^DEVICE^NOT_PRESENT 

U$BO_ERRXONTROL_NOT^SUPPORTED 

USBIO_ERR_TIMEOUT 

USBKi_ERR_INVALID^RECIPIENT 

USBIO_ERR_INVALID_TYPE 

USBIO_EflRJNVALID_IOCTL 

USBIO.ERRJNVALID^DIRECTION 

USB»0_ERR,TOO_MUCHJSO_PACKETS 

USBIO_ERR_POOL_EMPTY 

USBd_ERR^PIPE_NOT^FOUND 

USBIO_ERRJNVALID_ISO^PACKET 

USBKD_ERR_OUT_OFJVDDRESS^$raCE 

USBIO. ERR_INTERFACE_NOT_FOUMD 

USBIO_EflRJNVALID_DEVCE„.STATE 

USBIO_ERR_INVALID_PARAM 

USBK>_ERR_DEMO_ EXPIRED 

USBIO_ERRJNVALID^POWER_STATE 

USBIO_EflR^POWERJX>WN 

USBIO,ERR^VERSION_MISMATCH 

USBK)„ERR,SET^CONFIGURATION„FAILED 

USBK)_ERR,VID_RESTRICTION 

USBIO„EflRJSO_RESTRICTION 

USBIO_ERR_BULK,RESTRICTION 

USBCLERR^EPO_RESTRCTK>N 

USBIO_ERR_PIPE_RESTRICTION 

USBO_ERR_PIPE_SIZE^RESTRICTION 

USBK)_ERR_DEVICE_NOT_FOUND 

USBO_ERR_DEVICE_NOT_OPEN 

USBO_ERR^NO^SUCH^DEVICE_INSTANCE 

USBiQ_ERR_INVALID_FUNCTION_PARAM 



(OxE0001009L) 
(OxEOOOIOOAL) 
(OxEOOOIOOBL) 
(OxEOOOIOOCL) 
(OxEOOOIOOOL) 
(OxEOOOIOOEL) 
(OxEOOOIOOFL) 
(0xE0001010l) 
(OxEOOOIOUL) 
(0xE0001012L) 
(OxE0001013L) 
(OxE0001014L) 
(OxEO0O1O15L) 
(0xE0001016L) 
(OxE0001017L) 
(0xE0001018L) 
(OxE0001019L) 
(OxEOOOIOIAL) 
[0xE000101BU 
(OxEO0O1O1CL) 
(0xE000101DL) 
(OxE0001080L) 
(OxE0001081 L) 
(OxE0OO1O82L) 
(OxE0001083L) 
(OxE0001084L) 
(OxE0OO1O85L) 
(OxEOOOIIOOL) 
(OxE0001102L) 
(OxE00D11O4L) 
(OxE0OO11O5L) 
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E.O USBIO Class Library 



The USBIO Class Library (USBIOLIB) contains classes which provide 
wrapper functions for all of the features supported by the USBIO 
programming interlace. Using these classes in an opplcation is more 
convenient than using the USBIO interface directly. The classes are 
designed to be capable of being extended. In order to meet the 
requirements of a particular application new classes may be denved 
from the existing ones. The class library is provided fully in source code. 

Figure E-4 shows the classes included in the USBIOLIB and their 

relations. 
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) 



Figure E-4. USBIO Class Library 



E&A CUsblo Class 



The class CUsblo implements the basic interface to the USBIO device 
driver. It includes all functions that are related to an USBIO device 
object, Thus, by using on instance of the CUsblo class all operations 
which do not require a pipe context can be performed. 

The CUsblo class supports device enumeration and an Open tunction 
that is used to connect an instance of the class to an USBIO device 
object The handle that represents the connection is stored insiote the 
class instance. It is used for all subsequent requests to the device. 
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Foreach device- related operation the U SBIO driver supports, a member 
function exists in the CUsblo cfass. The tuncton takes the parameters 
that are required tor the operation and returns the status that is reported 
by the USBIO driver 



E.6.2 CUsbloPipe Class 



The class CUsbloPipe extends the CUsblo class by functions that are 
related to an USBIO pipe object. An instance of the CUsbloPipe class 
is associated directly with an USB \0 pipe object. In order to establish the 
connection to the pipe the class provides a Bind function. After a 
CUsbloPipe instance is bound, pipe-related functions can be 
performed by using member functions of the class, 

Foreach pipe-related operation that the USBIO driver supports a 
member function exists in the CUsbloPipe class. The turction takes 
the parameters that are required for the operation and returns the status 
that is reported by the USBIO driver 

The CusbloPipe class supports an asynchronous communication 
model for data transfers from or to the pipe. The Read or Write function 
is used to submit a data buffer to the USBIO driver The function returns 
immediately indicating success if the buffer was sent to the driver 
successfully. There is no blocking within the Read or Write function. 
Therefore, it is possible to send multiple buffers to the pipe. The buffers 
are processed sequentially in the same order as they were submitted. 
The WaitForCompietion member functton is used to wait until the 
data transfer from or to a particular buffer is finished. This function blocks 
the calling thread until the USBIO driver has completed the I/O operation 
with the bulfer. 

In order to use a data buffer with the Read. Write, and 
WaitForCompietion functbns of the CUsbloPipe class the buffer 
has to be described by acUsbloBuf object. The CUsbloBuf helper 
class stores context information while the read or write operation is 
pending. 
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E.6.3 CUsbloThread Class 

The class CUsbloThread provides basic functions needed lo 
implement a worker thread that performs input or output operations on a 
pipe. It includes functions that are used to start and stop the worker 
thread 

The CUsbloThread class does not implement the thread's main 
routine. This has to be done in aderived class. Thus É CUsbloThread is 
an universal base class that simplifies the implementation of a worker 
thread that performs cooperations on a pipe. 

NOTE: The worker thread created by CUsbloThread is a nativesystem thread. 
That means it cannot be used to class MFC (Microsoft Foundation 
Classes) functions. It is necessary to use PostMessage. 
SendMessage or some other communication mechanism toswitchover 
to MFC-aware threads. 



E.6.4 CUsbtoReaderClass 

The class CUsbloReader extends the CUsbloThread class by a 
specific worker thread routine that continuously sends Read requests to 
the pipe. The thread's main routine gets buffers from an internal buffer 
pool and submits them to the pipe using the Read function of the 
CUsbloPipe class. After all buffers are submitted the routine warts for 
the first pending buffer to complete. If a buffer is completed by the 
USBIO driver the virtual member function ProcessDat a is called with 
this buffer Within this function the data received from the pipe should be 
processed. The ProcessData function has to be implemented by a 
class that is derived from CUsbloReader. After that, the buffer is put 
back to the pool and the main loop is stated from the beginning. 



E.65 CUsbloWriter Class 



The class CUsbloWriter extends the CUsbloThreadclass by a 
specific worker thread routine that continuously sends Write requests to 
the pipe. The thread's main routine gets a buffer from an internal buffer 
pool and calls the virtual member function ProcessBuffer to fill the 
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buffer with data. After that É the buffer is sent to the pipe using the Write 
function of the CUsbloPipe class. After all buffers are submitted the 
routine waits for the first pending buffer to complete. If a buffer is 
completed by the USBIO driver the buffer is put back to the pool and the 
main loop is started from the beginning. 



E.6*6 CUsbloBulClass 



The helperclass CUsbloBuf is used as adescriptortor buffers that are 
processed by the class CUsbloPipe and derived classes. One instance 
of the CUsbloBuf class has to be created foreach buffer The 
CUsbloBuf object stores context and status informatbnthat is needed 
to process the buffer asynchronously. 

The CUsbloBuf class contains a link element (Next pointer). This may 
be usedtobuikJ achainof linked bufferobjects to hold them in a list. This 
way É the management of buffers can be simplified. 



E.6.7 CUsbloBufPool Class 



The class CUsbloBufPool is used to manage a pool of free butlers. It 
provides functons used to albcate an initial number of buffers, to get a 
buffer from the pool and to put a buffer back to the pool. 



E.7 USBIO Demo Application 



The USBIO Demo Application demonstrates the usage of the USBIO 
driver interface. It is based on the USBIO Class Library which covers the 
native API calls. The Application is designed to handle one USB driver 
that can contain multiple pipes. It is possible to run multiple instances of 
the application, each connected to another USB devce. 

The USBIO Demo Application is a dialog based MFC (Microsoft 
Foundation Classes) application. The main dialog contains a button that 
allows to open an output window. All output data and all error messages 
are directed to this window. The button "Clear Output Window' discards 
the actual contents of the window. 
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The main dialog contains several dialog pages which allow to access the 
device- related driver operations. From the dialog page "Pipes* a 
separate dialog can be started tor each configured pipe. The pipe 
dialogs are non-modal More than one pipe diabg can be opened at a 
given point in time. 



E.7.1 Dialog Pages for Device Operations 
E.7AJ Device 



E.7.1.2 Descriptors 



This page allows to scan tor available devices. The application 
enumerates lhe USBIO device objects currently available. It opens each 
device object and queries the USB device descriptor. The USB devces 
currently attached to USBIO are listed in the output window. A device 
can be opened and ctosed, and thedevice parameters can be requested 
or set. 

Related driver interfaces; 

m CreateFileO ; 

• CloaeHandle () ; 

• IOCTL_USBIO_GET_DEVICE_PARAMETERS (page 164) 
- IOCTL_USBIO_SET_DEVICE_PARAMETERS (page 165) 



This page allows to query standard descriptors from the device. The 
index of the configuration and the strong descriptors can be specified. 
The descriptors are dumped to the output window. Some descriptors are 
interpreted. Unknown descriptors are presented as HEX dump- 

Related driver interfaces: 

- IOCTL_USBIO_GET_DESCRIPTOR (page 151) 
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E>7.!.3 Configuration 



EJ.1A Interface 



E7.T.5 Pipes 



This page is used to set a configuration, to unconligure thedevCe.orto 
request the current configuration. 

Relaled driver interfaces; 

- IOCTL_USBIO_GET_DESCRIPTOR (page 151) 

• IOCTLJJSBIO_GET_CONFK3URATION (page 156) 

• lOCTL_USBIO_STORE_CONRG_DESCRIPTOR (page 156} 

• IOCTLJJSBIO_SET_CONFIGURATION (pag? 159) 

- IOCTLJJSBIO_UNCONFK3URE_DEVICE (page 160) 



By using this page the alternate setting ot a configured interlace can be 
changed, 

Related driver interfaces: 

• IOCTL_USBIO_SET_INTERFACE (page 161) 

- IOCTL_USBIO_GETJNTERFACE (page 157) 



This page allows to show all configured endpoints and interfaces by 
using the button 'Get Configuration Info'. A new non-modal dialog for 
each configured pipe can be opened as well. 

Related driver interfaces: 

• IOCTLJJSBIO_GET_CONFK3URATIONJNFO (psge 1 66) 
- IOCTL_USBIO_BIND_PIPE (page 174) 

• IOCTL_USBIO_UNBIND_PIPE (page 1 75) 
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E.7.JM Class or Vendor Request 



EJ.t.7 Feature 



EJJ.8 Other 



By using this page aclass or vendor specrfe request can be send to the 
USB device. 

Related driver interfaces: 

- IOCTLJJSBIOj;LASS_OR_VENDORJN_REQUE3T 

(page 162) 

• lOCTL_US8IO_CLASS_OR_VENDOR_OUT_REOUEST 

(page 163) 



This page can be used to send set or clear feature requests. 
Related driver interfaces: 

- IOCTL_USBIO_SET_FEATURE (page 153) 

- IOCTL_USBIO_CLEAR_FEATURE (page 154) 



This page allows to query Ihedevce state, lo reset tfe USB device, to 
gel the current trame number, and to query or set the device power state. 

Related driver interfaces: 

• IOCTL_USBIO_GET_STATUS(page 155) 

• IOCTLJJSBIO_RESET_DEVtCE (page 1 67) 

- [OCTLJJSBIOJ3ET_CURRENT_FRAME_NUMBER (page 1 68) 

• [OCTL_USBIO_SET_DEVICE_POWER_STATE (page 169) 

• lOCTLJJSBIO_GET_DEVICE_POWER_STATE (page 170) 
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EJ.U9 Dialog Pages for Pipe Operations 



EZIJO Pipe 



E.7.LÍ1 Buffers 



Three different types of pipe dialogs can be selected* For IN pipes a 
Read from pipe to file clia'og and a Read from pipe to output window 
dialog can be activated For OUT pipes a Write from file to pipe dialog 
can be started. The pipe dialog Read from pipe to output window 
cannot be used with isochronous pipes. 

When a new pipe dialog is opened it is bound to a pipe If the dialog is 
closed the pipe is unbound. Each pipe dialog contains pipe-related and 
transfer- related functions. The first three dialog pages are the same in 
all pipe dialogs* The last page has a special meaning. 



By using this page it is possible to access functions Reset Pipe, Abort 
Pipe, Get Pipe Parameters, and Sel Pipe Parameters. 

Related driver inlerf aces: 

• IOCTL_USBIO_RESET_PIPE (page 1 76) 

• IOCTLJJSBIO_ABORT_PIPE (page 177) 

• IOCTL_US8IO_GET_PIPE_PARAMETEHS (page 1 78J 
- IOCTL_USBIO_SET_PIPE_PARAMETERS (page 179) 



By means of this page the size and the number of buffers can be 
selected. For interrupt and Bulk pipes the * Size of Buffer* fieid is 
relevant. For Isochronous pipes the ^Number of Packets' field is relevant 
and the required buffer size is calculated internally. In the ^Max Error 
Count* field a maximum number of errors can be specified. When this 
number is exceeded, the data Iransfer is aborted. Each successful 
transfer resets the error counter to zero. 
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EJ.1J2 Control 



This dialog page allows to access user-defined control pipes It cannot 
be used to access the default pipe (endpoint zero) of an USB device. 

Related driver Interfaces; 

• IOCTL_US8IO_PIPE_CONTROL_TRANSERJN (page 180) 

- IOCTLJJSBIO_PIPE_CONTROLJTRANSFER_OUT (page 1 8: ) 



E> 7. J. 13 Read from Pipe to Output Window 



This dialog page allows to read data from an Interrupt or Bulk pipe and 
to dump It to the output window. For large amounts of dato the transfer 
may be slowed down because of the overhead involved with printing to 
the output window. The printing of the data can be enabled/disabled by 
the switch Prlnl to Output Window 

Related driver interfaces: 

• ReadFileO ; 

• IOCTLJJSBIO_ABORT_PIPE (page 177) 



E.7.1J4 Read from Pipe to File 



This dialog page allows to read data from the pipe to afile This transfer 
type can be used for Isochronous pipes as well The synchronization 
type of the Isochronous pipe has to be ^asynchronous*. The application 
does not support data rate feedback 

Related driver interfaces: 

- ReadFileQ ; 

• IOCTLJJSBIO_ABORT_PIPE (page 177) 
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E.7.ÍJ5 Write trom File to Pipe 



This dialog page allows to wrrie data from a tile to the pipe. This transfer 
type con be used for Isochronous pipes as well The synchronization 
type of the isochronous pipe has to be "asynchronous*. The application 
does not support data rate feedback 

Related driver interfaces: 

• WriteFileO ; 

• IOCTLJJSBIO_ABORT_PIPE (page 177) 



E.S Installation Issues 

This section discusses the topics related to installation of the US8IO 
device driver Included is a description of how a customized driver setup 
can be built. 

IMPORTANT: On Windows 2000 administrator lights are required to install adevice 
driver. Because the USBIO driver is installed in the same way as any 
other Plug&Play devee driver the installation requires administrator 
rights. Once the USBIO driver is installed standard user rights are 
sutficient to load the dnver and to use the driver by accessing Its 
programming interlace, 



E.8.1 Automated Installation: The USBIO Installation Wizard 

Using the USBIO Installation Wizaiti is the quietest and easiest way for 
installing the USBIO device driver. This wizard performs the dnver 
installation automatically in o step-by-step procedure* The device the 
USBIO driver will be installed for can be selected trom a list, it is not 
necessary to manually edit or copy any fites. After installation is 
complete the wizard allows to save the specific setup files that has been 
generated for the selected device. These files can be used at a later time 
to manually install the USBIO driver for the same device, without using 
the Installation Wizard. 
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The steps required to install the USBIOdriver by using the Installation 
Wizard are described below. 

• On Windows 2000 make sure you are logged on as an 
administratoror have enough privileges to install device drivers on 
the system. In general, speciaJ privileges are required to install 
device drivers on Windows 2000. 

• Connect your USB device to the system. After pugging in the 
device Windows launches the New Hardware Wizard and prompts 
you for adevce driver. Complete the New Hardware Wizard by 
clicking Next on each page and Finish on the last page. Windows 
either installs a system- provided driver or registers the device as 
"Unknown*. 

Do not abort the New Hardware Wizard byclicking the Cancel 
button. This will prevent Windows from enumerating the device 
and storing enumeratbn information in the registry. As a result of 
this, the device is not visible in the system and USBIO Installation 
Wizard is not able to install the driver for it. 

For some kinds of devices the system does not launch the New 
Hardware Wizard. A system- provided device driver will be 
instaJled silently. This will happen rf the device belongs to a 
predefined device class. Human Interface Devices (HID), Audio 
Devices, or Printer Devices for example. The USBIO Installation 
Wizard is able to install the USBIO driver tor such devces but this 
will disable any system-provided driver. 

• Start the USBIO Installation Wizard by selecting the appropriate 
shortcut from the Start menu. It is also possible to start the wizard 
directly by executing USBIOwiz.exe. 

• The first page shows some hints concerning the installation 
process. Click the Next button to continue. Note that you can abort 
the Installation Wizard at anytime byclicking the Cancel button, 

• On the next page the wizard shows a list containing all USB 
devices currently connected to the system. Select the device the 
USBIOdriver shall be installed for. The Hardware I D will be shown 
for the selected device. A Hardware ID is a string that is used 
internally by the operating system to unambiguously tientify the 
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device. It is built from a bus identifier (USB), the 16-bit vendor ID 
(VI D), the 16-bit product ID (PID). and optionally the revisbn code 
(REV). The IDs and the revision code are reported by the device 
in he USB Device Descriptor 

II yourdevice is not shown in the list make sure it is plugged in 
properly and you have finished the New Hardware Wizard as 
described above. You may use the Device Manager to check if the 
device was enumerated by the system. The Device Managercan 
be accessed by right-clicking the "My Computer' icon on the 
desktop and then choosing Properties. 

Use the Refresh button to rescan lor active devices and to rebuikJ 
the list 

To continue, click the Next button. 

• The next page shows detailed informatbn about the selected USB 
device. If a driver is already installed for the device information 
about the driver is also shown. Verify that you selected the correct 
device. If not, use the Back button to return to the device list and 
select another device. 

To install the USBIO driver for the selected device, click the Next 
button. 

WA RNING: If you install the USBIO driver for a device that is currently controlled by 
another device driver the existing driver will be disabled. This will happen 
immediately. As a result, the device may no longer be used by the 
operating system and by applications. If the device belongs to the HID 
class, a mouse or a keyboard for example, this can cause problems. 

• On the last page the Installation Wizard shows the completion 
status of driver installation. If the installation was successful the 
USBIO driver is running. It has been dynamcally baded by the 
operating system. 

The USBIO Installation Wizard allows you to save the specific 
driver installation file (INF) that it generated for the device. The INF 
file is specific for the selected device because it contains the 
Hardware ID of that device. You can use the button labeled "Save 
INF file" to save the generated INF file with anameot yourchoce 
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and rn a location of your choice. The installation Wizard copies 
also the US8IO driver binary die usbio.sys to the same location as 
lhe INF tile. You can use these files at a later time to install lhe 
USBIO driver manually. 

You can use the button labeled "Run USBIO Application' to start 
the demo application that is included in the USBIO package The 
application allows you to test several USB operations manually. 
Please refer to E.7 USBIO Demo Application for further 
information. 

To quit the USBIO Inslallation Wizard, click Finish. 



E-8.2 Manual Installation: The USBIO Setup Information File 

A Setup Information File (INF) is required for proper installation of the 
USBIO device driver This file describes the driver to be installed and 
defines the operations to be perlormed during the inslallation process 

An INF file is in ASCII text format It can be viewed and modified with any 
text editor. Notepad forexample. The contents and the syntax of an INF 
file are documented in the Microsoft Windows 2000 DDK, 

The INF file (s loaded and interpreted by a software component thai is 
built into the operating system, called Device Installer The Device 
Installer is closely related to the Plug&Play Manager that handles hot 
plugging and removal of USB devices. After the Plug&Play Manager has 
detected anew USB device the system searches its internal INF fitedata 
base, located in %wiNDlRfc\lNF\. tora malchingdriver. If nodrivercan 
be found the New Hardware Wizard pops up and the user will be asked 
for a driver 

The association of device and driver is based on a string that is called 
Hardware ID + The Plug&Play Manager builds the Hardware ID string 
from the 16-bit vendor ID (VID), the 16-brt product ID (PID), and 
optionally the revision code (REV). The stnng is prefixed by the bus 
identifier USB. Examples for Hardware ID strings are: 
USBA/ID_04GD&PID_01 00 
USB/VID_046D&PID_C00i&REV_04Q1 
USB/CLASS_09&SUBCLASS_01&PROT_00 
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As shown in the last example a Hardware ID can also describe a device 
class and subclass. This makes it possible to provide a driver that will be 
used whenever the system detects a device that belongs to a specific 
device class. Anexample for such a kind of driver is the system-provided 
HID mouse driver This driver is installed for any type of USB mouse, 
regardless ol the vendor, the USB Vendor ID, and the USB Product ID. 
The driver selectcn is based on the class, subclass, and protocol 
identifiers. Please refer to the Microsoft Windows 2000 DDK for detailed 
information on Hardware IDs and driver selection algorithms. Another 
good source of information are the INF fites that ship with the operating 
system. They are located in a subdirectory of the Windows system 
directory, named ~INF\ Note that on Windows 2000 this subdirectory 
has a Hidden attribute by default. 

In order to prepare an installation disk that can be used to install the 
USBIO driver tor your device the following steps are required. 

• Copy the USBIO driver binary usbio.sys to a floppy disk or to a 
directory location of your choice. Copy the INF tile usbb.int 
provded with the USBIO package to the same location. Note that 
you can choose any name for the INF file, based on your company 
name or your product name forexample. But the tile name 
extensbn has to be .inf. In the following discussion it is assumed 
the INF file is named usbio.inf. 

• Open the usbio.inf file using a text editor. Notepad tor example. 
Edit the [_Devices] section. There are various examples of 
Hardware ID strings prepared in this section. Select one ot the 
examples that matches your needs. Usually, the very first example 
is appropriate. It associates the USBIO driverwith your device by 
using the USB Vendor ID and Product ID. Remove the semi-colon 
at the start of the line and replace the VID_XXXX and PID_XXXX 
placeholders in the Hardware ID string by your USB Venotor ID 
and Product ID as shown in the examples above. Note that the IDs 
are given as 4-digit hexadecimaJ numbers. 

• Edit the [Strings] section at the end of the usbio.inf tile to 
modrfy the device description string tor your device, defined by the 
value of S_DeviceDescl. The device description text will be 
displayed in the Device Manager next to the icon that represents 
your device. 

• Save the INF file to accommodate your changes. 
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Now you are prepared to start the driver Installation, The required steps 
are described below. 

• Connect your USB device to the system, Atter plugging in the 
device Windows launches the New Hardware Wizard and prompts 
you for a device driver. Provide the New Hardware Wizard with the 
location of your installation files (usbio.inf and usbio.sys). 
Complete the wizard by foltowing the instructions shown on 
screen. If the INF file matches with yourdevce the driver should 
be installed successfully. 

Note that on Winctows 2000 and Windows Millennium the New 
Hardware Wizard shows awarning message that complains about 
the fact that the driver is not certified and digitally signed. You may 
igrore this warning and continue with driver installation. The 
USBIO driver is not certified because it is not an end-user product. 
When the USBIO driver is integrated into such a product it is 
possible to get a certification and a digital signature from the 
Windows Hardware Quality Labs (WHOL). 

* If the devce belongs to a predefined device class that is supported 
by the operating system, the system does not launch the New 
Hardware Wizard after the device is plugged in. Instead of that a 
system-provtíed device driver will be installed silently. Human 
Interface Devices (HID) like mice and keyboards, Audio Devices, 
or Printer Devices are examples for such devices. The operating 
system does not ask for a driver because it finds a matching entry 
for the device's class and subclass ID in its internal INF file data 
base, as mentioned above. 

Use the Device Manager to install the USBIO driver for a devce 
for that a driver is already running. To start the Device Manager 
choose Properties on the "My Computer* icon on the desktop. In 
the Device Manager locate your devce arxJ choose Properties on 
the entry. On the property page that pops up chDose Driver and 
click the button labeled ''Update Driver*. The Upgrade Device 
Driver Wizard is started whch is similar to the New Hardware 
Wizard mentioned above. Provide the wizard with the locatbn of 
your installatbn files (usbio.inf and usbio.sys) and complete the 
driver installation by following the instructions shown on screen. 
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■ For some device classes, especially HID devices HKe mice are! 
keyboards. Windows does nol allow you to install a driver with a 
different device class* Thai means you have to modify lhe device 
class entry In the [Version] section of the usbb.inf file to match 
with the device's class. The device class Is specified by the 
Keywords Class and ClasaGUID in the [Version] section, 

For example, if you want to use a keyboard or a mouse to est the 
USBIO driver the new entries should be 

Class=HIDClass and 

ClassCUID=(745al7a0-74d3-lld0-b6fe-00a0c90f57da>. 

The ClassGUID value that is associated with a device class can 
be found in system-provided INF files In wiNDlRfe\ INF\ or in 
the Windows 2000 DDK documentation, 

NO TE: At least two drivers are used for USB keyboard and nwuse devices. One 
belongs to the USB HID doss and the other one belongs to the keyboard 
or mouse class. The keyboard or mouse driver runs on top of the USB 
HIDdrlver. The USBIO driver can replace the USB HID driver only. Inthe 
Device Manager the HID driver is shown In a section labeled "Human 
Inter/ace Devices". To be sure to replace the correct driver refer to the 
~DriverFile Details* dialog in the Properties page of the entry. If the dnver 
stack contains the fíle HIDUSB.SYS then you have selected the correct 
entry in the Device Manager. 

■ Inthe Device manager the section 'Universal Serial Bus 
controllers' contains an item labeled * USB Root Hub\ 

Oo not install USBIO for the USB Root HUB! 

The USB Root Hub is not an USB device. It is buill into the USB 
host controller and is controlled by a special device driver provided 
by the operating system. 

• Alter the driver installation was successfully completed your 
devce should be shown in the Device Manager in the section that 
corresponds to the device class you specified Inthe usbio.inf file. 
You may use the Properties dialog box of that entry to verity that 
the USBIO driver is installed and running, 

• In order to verify that the USBIO driver is working properly with 
your device you should use the USBIO Demo Application 
USBIOAPP.EXE. Please refer to E.7 USBIO Demo Application 
for detailed information on the Demo Application 
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E.8.3 Uninstalling USBIO 



In order to uninstaJI USBIO for a given device lhe Device Manager has 
to be used. The Device Manager can be accessed by right-clicking on 
'My Computer* icon on the desktop and then choosing Properties. In the 
Device Manager double-click on the entry of the devce and choose the 
property page that is labeled "Driver*. There are two options: 

• Remove the device from the system by clicking the button 
"Uninstair. The operating system will reinstall a driver the next 
time the devce is connected or the system is rebooted. 

* Install a new driver for the device by clcking the button ** Update 
Driver*. The operating system launchs the Upgrade Device Driver 
Wizard which searches for driver files or lets you select a driver. 

In order to avoid that USBIO is reinstalled automatically and silently by 
the operating system it is necessary to manually remove the INF file that 
was used to install the USBIO driver 

During driver installation Windows stores a copy of the INF file in its 
internal INF file data base that is located in feWiNDlRfc\lNFVThe 
original INF file is renamed and stored as ocr^X. inf for example, where 
X is adecimal number The exact INF naming scheme depends on the 
operating system (Windows 2000 uses a slightly different scheme than 
Windows 98). The best way to find the correct INF file is to do a search 
for some significant string in all the INF files in the directory 
fcWlNDlRK\lNF\ and its s ud (rectories. 

Note that on Windows 98 and Windows ME the INF file may also be 
stored in a directory named fcWlNDlRfc\lNF\OTriERy Another naming 
scheme based on the provider name is used in that case. 

Note also that on Winctows 2000 the feWlH)lR«\lNF\ directory has a 
Hidden attribute by default. Therefore, the directory is not stown in 
Windows Explorer by default. 

Once you have located the INF file, delete it. This will prevent Windows 
from reinstalling the USBIO driver. Instead of that the New Hardware 
Wizard will be launched and you will be asked for a driver. 
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E.8.4 Building a Customized Driver Setup 

When the USBIO driver is included and shipped with a retail product 
some setup parameters should be customized. This is necessary 
because the USBIO device driver might be used by several vendors and 
it is possible that an user has two products and that both of them use the 
USBIO driver This can cause conflicts wrth respect to the tile name of 
the driver executable, the location of registry parameters, the device 
names, and the driver interface GUIDs usedTo avoid such problems a 
vendor who redistributes the USBIO driver for use wrth a hardware 
product should choose a new tile name for the driver binary, generate a 
private interface GUID. and select a private location in the registry to be 
used to store startup parameters. In order to do that the usbio.inf file has 
to be customized as well 

The following list shows the steps required to build acustomized USBIO 
setup: 

* Choose a new name for the driver binary tite usbio.sys. The name 
should not cause conflcts with drivers provided by Windows. 
Rename the file usbio.sys to your new name. 

* Rename the Setup Information file usbioJnf . You can choose any 
name you want. For instance, the name may be based on your 
companies or your product's name. Note that the fite extension 
should not be changed. It has to be ",inf\ 

* Edit the [_CopyFiIes_sys] section in the INF file to include the 
new name of the driver binary. 

* Edit the value S_DriverNa»e in the [Strings] section to 
match with the new name you defined for the driver binary. 

* Edit the [Strings] section in the INF file to modify text strings 
that are shown at the user interlace teve! You may change the 
following parameters: 

S_Provider 

S_Mfg 

S_DeviceClassDisplayNane 

S_DeviceDescl 

S_DiskName 

S_ServiceDisplayName 
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Edit the following values (n lhe [Strings] section to specify o 
location in the Registry thai is used to store the USBIO driver's 
configuration parameters: 

S_Conf igPath 

S_DevioeConf igPathl 

Note the S-Conf igPath should specify a location that is a 
subkey of 

BKEY_LOCAL_>ffiCrt rKE\SYS7EM\CuET^ntControlSet\Scrvic^s. 
The name of the subkey should be the same as the name you 
choosed for the driver binary. 

Generate a private Globally Unique Identifier (GUID) to 
unambiguously identify the device instances that will be created 
by USBIO for your devce. Use GUIDGEN.EXE Irom the Microsoft 
Platform SDK or from the Visual C++ package for this purpose. 
Copy the text representation ot the GUID to the line in the INF file 
that ctefines the registry value OSBIO_OserInterf aceGuid. 
Activate this line by removing the '*;' at the beginning. Use the 
private GUID in your application to search for available devices 
GUIDGEN EXE allows you to export a 

otatic const struct GUID - { *..) statement that can be 
included in the source code of an application. For an example, 
refer to the source code ol USBIOAPPor ReaderCpp. 

Edit the driver parameter settings in the sections 
_Parametersl_98 and_Para»eteral_N? The parameters in 
_Paramôtersl_98 define the default behavourof the USBIO 
driver on Windows 96. The parameters in _Parainetersl_NT 
defir»e the default behaviour of the USBIO driver on 
Wtndows 2000* For a detailed description of the supported 
settings, refer to E-9 Registry Entries. 

After you finished testing your INF file remove any lines and 
comments that are not needed. Especially, make sure that the 
word USBIO does not occur in the files you ship with your product. 
This is a requirement that is defined by the USBIO licensing 
conditions. See also the License Agreement you received with the 
USBIO package. 
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E,9 Registry Entries 



The behaviour of ths driver can be customized by startup parameters 
stored in the registry. The parameters are stored under a path that is 
specified in lhe INF tile. This registry path is 

KKÊV LOCAL. MACHINE '-5 fitem CunenlC nnírolSe t Bervices USBVO Parameters 

by default 

The location can be customized by changing the 5_Conf igPath and 
S_DeviceConf igPathi variables in the [Strings] sectbnofthe 
INF fife. 

The driver reads the parameters when a new device object is added. If 
a parameter does not exist when the driver attempts to read It, the driver 
creates the entry using an internal default value, 

Table E-3 lists all registry parameters* 



Table E-3. 


Reg 1st 

Min 


ry Parar 

Default 


leters 
Hu 


Supported by the USBIO Driver 




Value 




Description 




RequealTimeout 





1000 




Time-out interval lor synchronous I.O requests in 

milite condi 
Zero means infinite 4notme*outy, 




ShortTranslerOk 





1 


1 


11 set to 1 short packets in read transfers are 

allowed 
1| set to short packels in read Irani lera cause 

errors 




U nc oniigur e nC lo s e 


D 


1 


1 


H set to 1 lhe device *ni be unconfigured *hen lhe 

test tile nendle ■& dosed 
H set to lhe device stale is nol changed. 




ReselDeviceOnCIos? 


D 





» 


it set to 1 lhe device receives an USB reset it the 

fast tile nsndle ■& closed 
tt set lo lhe device slat? is nol changed. 




Enable Remote Wake up 





1 


1 


M set lo 1 Remote Wakeup is enabled* 
M set lo Remote Wakeup is disabled. 




MaxboPflckeis 


1€ 


64 


512 


Maximum number of packets allowed is an 
isochronous dala transfer. 




PowerStaieDnOpen 


D 





3 


Device paver stale that will be set when the device 

Is opened Hirst handle is opened). 
0^3 correspond to DO . D 3 
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Table E~3. Registry Parameters Supported by the USBIO Driver (Continued) 



Value 


Min 


Default 


Max 


Description 


FbwerS late OnC lose 





3 


3 


Device power slate ihai will be set when the device 

is closed (lasl hande is closed). 
0...3 correspond to DO . D 3 


MinPovverStateUsed 





3 


3 


The minimum power stale ot the device while it is 
used (open hardies exist). On system suspend 
the device is not allowed to go into slates higher 
thantNs value. 

D...3 correspond to DO .03 

The value (DO) means: no suspend allowed it the 
device is in use. 

The value 3 (03) means: lull suspend (ott) allowed 
it the device is in use. 


MinPovverStateUnused 





3 


3 


The minimum power state ot the device while it is 
not used frio open nancies exist) . On system 
suspend the device is not allowed to go into 
slates higher than this value. 

0...3 correspond to D0...D3 

The value (DO) means: no suspend allowed it 1 he 
device is not in use. 

The value 3 (03) means: lull suspend (ott) allowed 
it lhe device is not wr\ use 


Abor t Pipe sOn Powe r D own 








1 


Handing ot outs lancing read or write reqjests 
when the device goes into a suspend slate 
(leaves DO): 
1 = abort penclng requests 
= do not abort pendng requests 


S uppr e ss PnPRe move Dig 





1 


1 


It this llag is set. Windows 2000 does not show a 
warning dalogit the device is removed. 


DebugPori 








3 


Destination ot face messages tor debugging 
purposes: 
= kernel debugger or debug moritor 
1...3= COMI ...COM3 
This parameter is avail aWe oily it the debug 
(checked) build ot the USBIO driver is used. 


DebugMask 





3 




Control ot message output lor debugging. TNs 
parameter is available only it the debug (checked) 
build ot the USBIO driver is used. 


DebugBaud 


2,400 


57.600 


115.200 


Baucfrate selection tor debug ouipui to COM port. 
TNs parameter is available oriy it the debug 
(checked) buítd oí lhe USBIO driver is used. 
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E.10 Related Documents 



Universal Serial Bus Specification 1 .0. 1.1 

USB devce class specifications (Audb, HID. Printer etc. 

Windows 2000 DDK Documentation 

Windows 98 DDK Documentation 

Microsoft Platform SDK Documentation 



E.11 Light Version Limitations 



The light version for MCT Elektronikladenot the USBIO driver has the 
folbwíng limitations: 

1. The Vendor I D of your device has to match with the Vendor ID 
0x0C70 of MCT Elektronikladen. You can contact MCT 
Elektronikladen to receive a unique product ID. 

Possible error codes when this restriction is offended; 
USBIO_ERR_VID_RESTRICTION 

2. Only one Interrupt INendpoint and one Interrupt OUT endpoint is 
supported. If your device has moreendpoints or other endpoint 
types configuring the device (SET_CONFIGU RATION} will fail. 

Possible error codes when this restriction is offended; 
USBIO_ERR_PIPE_RESTRICTION 
USBIO_ERR_BULK_RESTRICTION 
USBIO_ERRJSO_RESTRICTION 

3. The maximum FIFO size of an endpoint is limited to eight bytes. 

Possible error codes when this restriction is offended; 
USBIO_ERR_PIPE_SIZE_RESTRICTION 

4. The maximum size of the data stage for a Class or Vendor 
Request is limited to eight bytes. 

Possible error codes when this restriction is offended; 
USBIO ERR EPO RESTRICTION 



USB08 Evaluafon Board Designer Reference Manual 

MOTOROLA Uriversal USB Device Driver {USBIO) 241 



Universal USB Device Driver (USBIO) 



Designer Reference Manual 



U5B08 Evaluation Boafd 



242 



Universal US8 Device Driver (USBIO) 



MOTOROLA 




How to Reach Us: 

LEA'EUn3FELOGATK)fte*DrU9TEft 
><b*rrfci Li fain- DfttfeiKVI 

PQ.&-NO? 

Lrnn fJoafc if C r 

hDXTMt40 

fflff>44VJir 

TS>NC A L*NFO i*l 4T»0N COMTEK 

i ■:■<*: o : ^." j 



I3 Pa Mstid Êtt* 

t< Pa HI. Hnj t'.'in 

1-CKiE PA5& 



nnMCKETD 



